Repository: qpid-site Updated Branches: refs/heads/asf-site f3f5c10b2 -> 32dce6b5a
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-jms-amqp-0-x-release-page ---------------------------------------------------------------------- diff --git a/scripts/gen-jms-amqp-0-x-release-page b/scripts/gen-jms-amqp-0-x-release-page new file mode 100755 index 0000000..98e6d27 --- /dev/null +++ b/scripts/gen-jms-amqp-0-x-release-page @@ -0,0 +1,198 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + +from generate import * + +from datetime import datetime + +download_records = ( + ("apache-qpid-jms-amqp-0-x-{}-bin.tar.gz", "Qpid JMS binaries"), + ("apache-qpid-jms-amqp-0-x-{}-src.tar.gz", "Qpid JMS source code"), + ) + +documentation = \ +""" +<div class="two-column" markdown="1"> + + - [API reference](http://docs.oracle.com/javaee/7/api/javax/jms/package-summary.html) + +</div> +""" + +template = \ +""" +;; +;; Licensed to the Apache Software Foundation (ASF) under one +;; or more contributor license agreements. See the NOTICE file +;; distributed with this work for additional information +;; regarding copyright ownership. The ASF licenses this file +;; to you under the Apache License, Version 2.0 (the +;; "License"); you may not use this file except in compliance +;; with the License. You may obtain a copy of the License at +;; +;; http://www.apache.org/licenses/LICENSE-2.0 +;; +;; Unless required by applicable law or agreed to in writing, +;; software distributed under the License is distributed on an +;; "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +;; KIND, either express or implied. See the License for the +;; specific language governing permissions and limitations +;; under the License. +;; + +# Qpid JMS for AMQP 0-x {release} + +Qpid JMS for AMQP 0-x is XXX. + +For a detailed list of the changes in this release, see the [release +notes](release-notes.html). + +[jms]: http://en.wikipedia.org/wiki/Java_Message_Service + +## Download + +It's important to [verify the +integrity]({{{{site_url}}}}/download.html#verify-what-you-download) of the +files you download. + +| Content | Download | Verify | +|---------|----------|--------| +{downloads} + +The client is also available [via Maven]({{{{site_url}}}}/maven.html). + +## Documentation + +{documentation} + +## More information + + - [All release artefacts](http://archive.apache.org/dist/qpid/jms-amqp-0-x/{release}) + - [Resolved issues in JIRA]({issues_url}) + - [Source repository tag](https://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x.git/tree/refs/tags/{source_release}) + +<script type="text/javascript"> + _deferredFunctions.push(function() {{ + if ("{release}" === "{{{{current_jms_amqp_0_x_release}}}}") {{ + _modifyCurrentReleaseLinks(); + }} + }}); +</script> +""" + +def gen_release_page(release, issues_release, source_release, release_dir): + output_path = join(release_dir, "index.md") + + downloads = list() + components = list() + + artifact_url_template = "http://archive.apache.org/dist/qpid/jms-amqp-0-x/{}/{}" + + for artifact, summary in download_records: + artifact = artifact.format(release) + artifact_url = artifact_url_template.format(release, artifact) + asc_url = "{}.asc".format(artifact_url) + md5_url = "{}.md5".format(artifact_url) + sha_url = "{}.sha".format(artifact_url) + + args = summary, artifact, artifact_url, asc_url, md5_url, sha_url + downloads.append("| {} | [{}]({}) | [ASC]({}), [MD5]({}), [SHA512]({}) |".format(*args)) + + downloads = "\n".join(downloads) + + jql = "project = QPID AND fixVersion = '{}' AND resolution = 'fixed' ORDER BY priority DESC".format(issues_release) + issues_url = "https://issues.apache.org/jira/issues/?jql={}".format(urllib.quote_plus(jql)) + + vars = locals() + vars["documentation"] = documentation.format(release=release, source_release=source_release) + + output = template.format(**vars) + output = output.strip() + + write(output_path, output) + +master_template = """ +;; +;; Licensed to the Apache Software Foundation (ASF) under one +;; or more contributor license agreements. See the NOTICE file +;; distributed with this work for additional information +;; regarding copyright ownership. The ASF licenses this file +;; to you under the Apache License, Version 2.0 (the +;; "License"); you may not use this file except in compliance +;; with the License. You may obtain a copy of the License at +;; +;; http://www.apache.org/licenses/LICENSE-2.0 +;; +;; Unless required by applicable law or agreed to in writing, +;; software distributed under the License is distributed on an +;; "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +;; KIND, either express or implied. See the License for the +;; specific language governing permissions and limitations +;; under the License. +;; + +# Qpid JMS for AMQP 0-x documentation snapshot + +<div class="feature" markdown="1"> + +## Warning! This is a snapshot of work in progress + +Documentation found here may be incorrect or incomplete. For a +smoother experience, see the [current stable +release]({{{{current_jms_amqp_0_x_release_url}}}}/index.html). + +This content was generated at {time} on {day}, {date}. + +</div> + +## Documentation + +{documentation} + +## More information + + - [Source repository](https://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x.git) +""" + +def gen_master_release_page(release_dir): + output_path = join(release_dir, "index.md") + + now = datetime.now() + + day = now.strftime("%A") + date = now.strftime("%d %B %Y") + time = now.strftime("%H:%M %Z") + + vars = locals() + vars["documentation"] = documentation.format(release="master", source_release="master") + + output = master_template.format(**vars) + output = output.strip() + + write(output_path, output) + +release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() + +if release == "master": + gen_master_release_page(release_dir) +else: + gen_release_page(release, issues_release, source_release, release_dir) + +notice("Release page generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-jms-release-docs ---------------------------------------------------------------------- diff --git a/scripts/gen-jms-release-docs b/scripts/gen-jms-release-docs index 99035f3..5c15c6a 100755 --- a/scripts/gen-jms-release-docs +++ b/scripts/gen-jms-release-docs @@ -20,7 +20,7 @@ from generate import * -def gen_docs(release, source_dir, output_dir): +def gen_jms_docs(release, source_dir, output_dir): docs_input_dir = join(source_dir, "qpid-jms-docs") docs_output_dir = join(output_dir, "docs") @@ -33,8 +33,8 @@ def gen_docs(release, source_dir, output_dir): ## Now do stuff ## release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() -source_dir = export_release_from_git("jms", source_release) +source_dir = checkout_dir or fetch_source("jms", source_release) -gen_docs(release, source_dir, release_dir) +gen_jms_docs(release, source_dir, release_dir) notice("Docs copied") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-jms-release-page ---------------------------------------------------------------------- diff --git a/scripts/gen-jms-release-page b/scripts/gen-jms-release-page index 87b6d20..51c3716 100755 --- a/scripts/gen-jms-release-page +++ b/scripts/gen-jms-release-page @@ -7,9 +7,9 @@ # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at -# +# # http://www.apache.org/licenses/LICENSE-2.0 -# +# # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY @@ -49,9 +49,9 @@ template = \ ;; to you under the Apache License, Version 2.0 (the ;; "License"); you may not use this file except in compliance ;; with the License. You may obtain a copy of the License at -;; +;; ;; http://www.apache.org/licenses/LICENSE-2.0 -;; +;; ;; Unless required by applicable law or agreed to in writing, ;; software distributed under the License is distributed on an ;; "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY @@ -141,9 +141,9 @@ master_template = """ ;; to you under the Apache License, Version 2.0 (the ;; "License"); you may not use this file except in compliance ;; with the License. You may obtain a copy of the License at -;; +;; ;; http://www.apache.org/licenses/LICENSE-2.0 -;; +;; ;; Unless required by applicable law or agreed to in writing, ;; software distributed under the License is distributed on an ;; "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY @@ -184,8 +184,6 @@ def gen_master_release_page(release_dir): date = now.strftime("%d %B %Y") time = now.strftime("%H:%M %Z") - - vars = locals() vars["documentation"] = documentation.format(release="master", source_release="master") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-proton-j-release-api-doc ---------------------------------------------------------------------- diff --git a/scripts/gen-proton-j-release-api-doc b/scripts/gen-proton-j-release-api-doc deleted file mode 100755 index 20f7fce..0000000 --- a/scripts/gen-proton-j-release-api-doc +++ /dev/null @@ -1,45 +0,0 @@ -#!/usr/bin/python -# -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# - -from generate import * - -# API docs - -def gen_api_doc(release, source_dir, release_dir): - input_path = join(source_dir, "proton-j", "src", "main", "java") - input_namespace = "org.apache.qpid.proton" - output_dir = join(release_dir, "api") - - remove(output_dir) - - gen_javadoc(release=release, - title="Qpid Proton-J API", - input_paths=(input_path,), - input_namespaces=(input_namespace,), - output_dir=output_dir) - -## Now do stuff ## - -release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() -source_dir = export_release_from_git("proton-j", source_release) - -gen_api_doc(release, source_dir, release_dir) - -notice("API documentation generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-proton-j-release-docs ---------------------------------------------------------------------- diff --git a/scripts/gen-proton-j-release-docs b/scripts/gen-proton-j-release-docs new file mode 100755 index 0000000..507d7a0 --- /dev/null +++ b/scripts/gen-proton-j-release-docs @@ -0,0 +1,43 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + +from generate import * + +def gen_proton_j_api(release, source_dir, release_dir): + input_path = join(source_dir, "proton-j", "src", "main", "java") + input_namespace = "org.apache.qpid.proton" + output_dir = join(release_dir, "api") + + remove(output_dir) + + gen_javadoc(release=release, + title="Qpid Proton-J API", + input_paths=(input_path,), + input_namespaces=(input_namespace,), + output_dir=output_dir) + +## Now do stuff ## + +release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() +source_dir = checkout_dir or fetch_source("proton-j", source_release) + +gen_proton_j_api(release, source_dir, release_dir) + +notice("Docs generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-proton-release-api-doc ---------------------------------------------------------------------- diff --git a/scripts/gen-proton-release-api-doc b/scripts/gen-proton-release-api-doc deleted file mode 100755 index 7ef69ae..0000000 --- a/scripts/gen-proton-release-api-doc +++ /dev/null @@ -1,110 +0,0 @@ -#!/usr/bin/python -# -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# - -from generate import * - -# API docs - -def gen_api_doc(release, source_dir, release_dir): - component_dir = join(release_dir, "proton") - - dir = change_dir(source_dir) - call("cmake .") - call("make all docs") - change_dir(dir) - - gen_c_api_doc(release, source_dir, component_dir) - gen_cpp_api_doc(release, source_dir, component_dir) - gen_python_api_doc(release, source_dir, component_dir) - -def gen_c_api_doc(release, source_dir, component_dir): - include_dir = join(source_dir, "proton-c", "include") - output_dir = join(component_dir, "c", "api") - config_file = join(source_dir, "proton-c", "docs", "api", "user.doxygen.in") - - remove(output_dir) - - gen_doxygen(release=release, - title="Qpid Proton C API", - input_paths=(join(include_dir, "proton"), - join(source_dir, "proton-c", "docs"), - join(source_dir, "examples", "c", "proactor", "README.dox"), - ), - strip_paths=(include_dir,), - output_dir=output_dir, - example_paths=(join(source_dir, "examples", "c", "proactor"),), - config_file=config_file) - -def gen_cpp_api_doc(release, source_dir, component_dir): - base_dir = join(source_dir, "proton-c", "bindings", "cpp") - include_dir = join(base_dir, "include") - output_dir = join(component_dir, "cpp", "api") - config_file = join(base_dir, "docs", "user.doxygen.in") - - remove(output_dir) - - gen_doxygen(release=release, - title="Qpid Proton C++ API", - input_paths=(join(include_dir, "proton"), - join(base_dir, "docs"), - join(source_dir, "examples", "cpp", "README.dox"), - join(source_dir, "examples", "cpp", "tutorial.dox"), - ), - strip_paths=(include_dir,), - output_dir=output_dir, - example_paths=(join(source_dir, "examples", "cpp"),), - config_file=config_file) - -def gen_python_api_doc(release, source_dir, component_dir): - input_path = join(source_dir, "proton-c", "bindings", "python") - input_namespace = "proton" - output_dir = join(component_dir, "python", "api") - - remove(output_dir) - - gen_epydoc(release=release, - title="Qpid Proton Python API", - input_paths=(input_path,), - input_namespaces=(input_namespace,), - output_dir=output_dir) - -# Book - -def gen_book(release, source_dir, release_dir): - component_dir = join(release_dir, "proton") - input_dir = join(source_dir, "proton-c", "bindings", "python", "tutorial") - output_dir = join(component_dir, "python", "book") - - remove(output_dir) - - copy(input_dir, output_dir) - touch(join(output_dir, "_transom_ignore_pages")) - - remove(join(output_dir, ".doctrees")) - -## Now do stuff ## - -release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() -source_dir = export_release_from_git("proton", source_release) - -gen_api_doc(release, source_dir, release_dir) -gen_book(release, source_dir, release_dir) - -notice("API documentation and tutorial generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-proton-release-docs ---------------------------------------------------------------------- diff --git a/scripts/gen-proton-release-docs b/scripts/gen-proton-release-docs new file mode 100755 index 0000000..8bc4e18 --- /dev/null +++ b/scripts/gen-proton-release-docs @@ -0,0 +1,145 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + +from generate import * + +def gen_proton_apis(release, source_dir, release_dir): + component_dir = join(release_dir, "proton") + build_dir = make_temp_dir() + + with working_dir(build_dir): + call("cmake {}", source_dir) + call("make all docs") + + gen_proton_c_api(release, source_dir, component_dir) + gen_proton_cpp_api(release, source_dir, component_dir) + gen_proton_python_api(release, source_dir, component_dir) + +def gen_proton_c_api(release, source_dir, component_dir): + include_dir = join(source_dir, "proton-c", "include") + output_dir = join(component_dir, "c", "api") + config_file = join(source_dir, "proton-c", "docs", "api", "user.doxygen.in") + + remove(output_dir) + + gen_doxygen(release=release, + title="Qpid Proton C API", + input_paths=(join(include_dir, "proton"), + join(source_dir, "proton-c", "docs"), + join(source_dir, "examples", "c", "proactor", "README.dox"), + ), + strip_paths=(include_dir,), + output_dir=output_dir, + example_paths=(join(source_dir, "examples", "c", "proactor"),), + config_file=config_file) + +def gen_proton_cpp_api(release, source_dir, component_dir): + base_dir = join(source_dir, "proton-c", "bindings", "cpp") + include_dir = join(base_dir, "include") + output_dir = join(component_dir, "cpp", "api") + config_file = join(base_dir, "docs", "user.doxygen.in") + + remove(output_dir) + + gen_doxygen(release=release, + title="Qpid Proton C++ API", + input_paths=(join(include_dir, "proton"), + join(base_dir, "docs"), + join(source_dir, "examples", "cpp", "README.dox"), + join(source_dir, "examples", "cpp", "tutorial.dox"), + ), + strip_paths=(include_dir,), + output_dir=output_dir, + example_paths=(join(source_dir, "examples", "cpp"),), + config_file=config_file) + +def gen_proton_python_api(release, source_dir, component_dir): + input_path = join(source_dir, "proton-c", "bindings", "python") + input_namespace = "proton" + output_dir = join(component_dir, "python", "api") + + remove(output_dir) + + gen_epydoc(release=release, + title="Qpid Proton Python API", + input_paths=(input_path,), + input_namespaces=(input_namespace,), + output_dir=output_dir) + +def gen_proton_books(release, source_dir, release_dir): + component_dir = join(release_dir, "proton") + input_dir = join(source_dir, "proton-c", "bindings", "python", "docs") + output_dir = join(component_dir, "python", "book") + + remove(output_dir) + + copy(input_dir, output_dir) + touch(join(output_dir, "_transom_ignore_pages")) + + remove(join(output_dir, ".doctrees")) + +def gen_proton_examples(release, source_dir, release_dir): + component_dir = join(release_dir, "proton") + + gen_proton_python_examples(release, source_dir, component_dir) + gen_proton_cpp_examples(release, source_dir, component_dir) + +def gen_proton_python_examples(release, source_dir, component_dir): + input_dir = join(source_dir, "examples", "python") + output_dir = join(component_dir, "python", "examples") + source_url = get_git_release_branch_url("proton", release, "examples/python") + readme_url = "{}/README".format(source_url) + input_names = list_dir(input_dir, "*.py") + + gen_examples(release=release, + lang="python", + title="Proton Python Examples", + input_dir=input_dir, + input_names=input_names, + output_dir=output_dir, + source_url=source_url, + readme_url=readme_url) + +def gen_proton_cpp_examples(release, source_dir, component_dir): + input_dir = join(source_dir, "examples", "cpp") + output_dir = join(component_dir, "cpp", "examples") + source_url = get_git_release_branch_url("proton", release, "examples/cpp") + readme_url = "{}/README.dox".format(source_url) + input_names = list_dir(input_dir, "*.cpp", "*.hpp") + + gen_examples(release=release, + lang="cpp", + title="Proton C++ Examples", + input_dir=input_dir, + input_names=input_names, + output_dir=output_dir, + source_url=source_url, + readme_url=readme_url) + +## Now do stuff ## + +release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() +source_dir = checkout_dir or fetch_source("proton", source_release) + +gen_proton_apis(release, source_dir, release_dir) +gen_proton_books(release, source_dir, release_dir) +gen_proton_examples(release, source_dir, release_dir) + +notice("Docs generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-proton-release-examples ---------------------------------------------------------------------- diff --git a/scripts/gen-proton-release-examples b/scripts/gen-proton-release-examples deleted file mode 100755 index eec35bd..0000000 --- a/scripts/gen-proton-release-examples +++ /dev/null @@ -1,156 +0,0 @@ -#!/usr/bin/python -# -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# - -from generate import * - -## Engine/Reactor ## - -def gen_proton_examples(release, source_dir, release_dir): - component_dir = join(release_dir, "proton") - - gen_python_proton_examples(release, source_dir, component_dir) - gen_cpp_proton_examples(release, source_dir, component_dir) - -def gen_python_proton_examples(release, source_dir, component_dir): - input_dir = join(source_dir, "examples", "python") - output_dir = join(component_dir, "python", "examples") - source_url = get_git_release_branch_url("proton", release, "examples/python") - readme_url = "{}/README".format(source_url) - input_names = list_dir(input_dir, "*.py") - - gen_examples(release=release, - lang="python", - title="Proton Python Examples", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - source_url=source_url, - readme_url=readme_url) - -def gen_cpp_proton_examples(release, source_dir, component_dir): - input_dir = join(source_dir, "examples", "cpp") - output_dir = join(component_dir, "cpp", "examples") - source_url = get_git_release_branch_url("proton", release, "examples/cpp") - readme_url = "{}/README.dox".format(source_url) - input_names = list_dir(input_dir, "*.cpp", "*.hpp") - - gen_examples(release=release, - lang="cpp", - title="Proton C++ Examples", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - source_url=source_url, - readme_url=readme_url) - - -## Messenger ## - -def gen_messenger_examples(release, source_dir, release_dir): - component_dir = join(release_dir, "messenger") - - gen_c_messenger_examples(release, source_dir, component_dir) - gen_perl_messenger_examples(release, source_dir, component_dir) - gen_php_messenger_examples(release, source_dir, component_dir) - gen_python_messenger_examples(release, source_dir, component_dir) - gen_ruby_messenger_examples(release, source_dir, component_dir) - -def gen_c_messenger_examples(release, source_dir, component_dir): - input_dir = join(source_dir, "examples", "c", "messenger") - output_dir = join(component_dir, "c", "examples") - source_url = get_git_release_branch_url("proton", release, "examples/c/messenger") - input_names = list_dir(input_dir, "*.c", "*.h") - - gen_examples(release=release, - lang="c", - title="C AMQP Messenger Examples", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - source_url=source_url) - -def gen_perl_messenger_examples(release, source_dir, component_dir): - input_dir = join(source_dir, "examples", "perl", "messenger") - output_dir = join(component_dir, "perl", "examples") - source_url = get_git_release_branch_url("proton", release, "examples/perl/messenger") - input_names = list_dir(input_dir, "*.pl") - - gen_examples(release=release, - lang="perl", - title="Perl AMQP Messenger Examples", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - source_url=source_url) - -def gen_php_messenger_examples(release, source_dir, component_dir): - input_dir = join(source_dir, "examples", "php", "messenger") - output_dir = join(component_dir, "php", "examples") - source_url = get_git_release_branch_url("proton", release, "examples/php/messenger") - input_names = list_dir(input_dir, "*.php") - - gen_examples(release=release, - lang="php", - title="PHP AMQP Messenger Examples", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - source_url=source_url) - -def gen_python_messenger_examples(release, source_dir, component_dir): - input_dir = join(source_dir, "examples", "python", "messenger") - output_dir = join(component_dir, "python", "examples") - source_url = get_git_release_branch_url("proton", release, "examples/python/messenger") - readme_url = "{}/README.txt".format(source_url) - - input_names = list_dir(input_dir, "*.py") - - gen_examples(release=release, - lang="python", - title="Python AMQP Messenger Examples", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - source_url=source_url, - readme_url=readme_url) - -def gen_ruby_messenger_examples(release, source_dir, component_dir): - input_dir = join(source_dir, "examples", "ruby", "messenger") - output_dir = join(component_dir, "ruby", "examples") - source_url = get_git_release_branch_url("proton", release, "examples/ruby/messenger") - input_names = list_dir(input_dir, "*.rb") - - gen_examples(release=release, - lang="ruby", - title="Ruby AMQP Messenger Examples", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - source_url=source_url) - -## Now do stuff ## - -release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() -source_dir = export_release_from_git("proton", source_release) - -gen_proton_examples(release, source_dir, release_dir) -gen_messenger_examples(release, source_dir, release_dir) - -notice("Examples generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-python-release-api-doc ---------------------------------------------------------------------- diff --git a/scripts/gen-python-release-api-doc b/scripts/gen-python-release-api-doc deleted file mode 100755 index 6a735d9..0000000 --- a/scripts/gen-python-release-api-doc +++ /dev/null @@ -1,44 +0,0 @@ -#!/usr/bin/python -# -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# - -from generate import * - -def gen_messaging_api(release, source_dir, release_dir): - component_dir = join(release_dir, "messaging-api") - remove(component_dir) - - input_path = join(source_dir, "python") - input_namespace = "qpid.messaging" - output_dir = join(component_dir, "api") - - gen_epydoc(release=release, - title="Qpid Python Messaging API", - input_paths=(input_path,), - input_namespaces=(input_namespace,), - output_dir=output_dir) - -## Now do stuff ## - -release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() -source_dir = export_release_from_git("python", source_release) - -gen_messaging_api(release, source_dir, release_dir) - -notice("API documentation generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-python-release-docs ---------------------------------------------------------------------- diff --git a/scripts/gen-python-release-docs b/scripts/gen-python-release-docs new file mode 100755 index 0000000..cbacb7a --- /dev/null +++ b/scripts/gen-python-release-docs @@ -0,0 +1,64 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + +from generate import * + +def gen_python_apis(release, source_dir, release_dir): + component_dir = join(release_dir, "messaging-api") + remove(component_dir) + + input_path = join(source_dir, "python") + input_namespace = "qpid.messaging" + output_dir = join(component_dir, "api") + + gen_epydoc(release=release, + title="Qpid Python Messaging API", + input_paths=(input_path,), + input_namespaces=(input_namespace,), + output_dir=output_dir) + +def gen_python_examples(release, source_dir, release_dir): + component_dir = join(release_dir, "messaging-api") + input_dir = join(source_dir, "examples", "api") + output_dir = join(component_dir, "examples") + + readme_url = "https://git-wip-us.apache.org/repos/asf?p=qpid-python.git;a=blob_plain;f=examples/README.txt;hb={}".format(release) + source_url = "https://git-wip-us.apache.org/repos/asf?p=qpid-python.git;a=tree;f=examples;hb={}".format(release) + + input_names = list_dir(input_dir) + + gen_examples(release=release, + title="Python Messaging API Examples", + lang="python", + input_dir=input_dir, + input_names=input_names, + output_dir=output_dir, + readme_url=readme_url, + source_url=source_url) + +## Now do stuff ## + +release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() +source_dir = checkout_dir or fetch_source("python", source_release) + +gen_python_apis(release, source_dir, release_dir) +gen_python_examples(release, source_dir, release_dir) + +notice("Docs generated") http://git-wip-us.apache.org/repos/asf/qpid-site/blob/32dce6b5/scripts/gen-python-release-examples ---------------------------------------------------------------------- diff --git a/scripts/gen-python-release-examples b/scripts/gen-python-release-examples deleted file mode 100755 index 4e4250f..0000000 --- a/scripts/gen-python-release-examples +++ /dev/null @@ -1,51 +0,0 @@ -#!/usr/bin/python -# -# Licensed to the Apache Software Foundation (ASF) under one -# or more contributor license agreements. See the NOTICE file -# distributed with this work for additional information -# regarding copyright ownership. The ASF licenses this file -# to you under the Apache License, Version 2.0 (the -# "License"); you may not use this file except in compliance -# with the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, -# software distributed under the License is distributed on an -# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -# KIND, either express or implied. See the License for the -# specific language governing permissions and limitations -# under the License. -# - -from generate import * - -## Messaging API ## - -def gen_messaging_api(release, source_dir, release_dir): - component_dir = join(release_dir, "messaging-api") - input_dir = join(source_dir, "examples", "api") - output_dir = join(component_dir, "examples") - - readme_url = "https://git-wip-us.apache.org/repos/asf?p=qpid-python.git;a=blob_plain;f=examples/README.txt;hb={}".format(release) - source_url = "https://git-wip-us.apache.org/repos/asf?p=qpid-python.git;a=tree;f=examples;hb={}".format(release) - - input_names = list_dir(input_dir) - - gen_examples(release=release, - title="Python Messaging API Examples", - lang="python", - input_dir=input_dir, - input_names=input_names, - output_dir=output_dir, - readme_url=readme_url, - source_url=source_url) - -## Now do stuff ## - -release, issues_release, source_release, release_dir, checkout_dir = setup_release_script() -source_dir = export_release_from_git("python", source_release) - -gen_messaging_api(release, source_dir, release_dir) - -notice("Examples generated") --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@qpid.apache.org For additional commands, e-mail: commits-h...@qpid.apache.org