Repository navigation
[20.0][MIG] upgrade_analysis #3748
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
hbrunn
wants to merge
151
commits into
OCA:20.0
Choose a base branch
from
hbrunn:20.0-mig-upgrade_analysis
base: 20.0
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
151 commits
Select commit
Hold shift + click to select a range
f83c000
[MOVE] openupgrade_records : move module from OCA/OpenUpgrade (branch…
legalsylvain d4b4307
[REF] rename module openupgrade_records into upgrade_analysis
legalsylvain fbe6090
[REF] rename files, apply OCA convention, remove obsolete 6.1 syntax,…
legalsylvain 81c24cf
[IMP] upgrade_analysis: improve install wizard to have the possibilit…
legalsylvain f30ffff
[MOVE] Port patches and framework from openupgrade project
legalsylvain 4b22e80
[REF] rename framework files, adapt to new module names, remove print…
legalsylvain eb9fc95
[RFR] Improve patchwork
StefanRijnhart e9b496e
[IMP] Create records with timestamp; [RFR] No /migration/ level when …
StefanRijnhart 7ab00a3
[FIX] ImportError;
StefanRijnhart 58e31a2
[IMP] various improvment from Yajo.
legalsylvain 12896d6
[IMP] import apriori file of openupgrade_scripts, if available
legalsylvain 66b8cb3
[RFR] upgrade_path not user writable
StefanRijnhart ca35944
[ADD] Generate noupdate_changes
StefanRijnhart b653611
[FIX] dataclasses for Python < 3.7
StefanRijnhart daa6ad7
Update upgrade_analysis/models/ir_module_module.py
legalsylvain f8dc207
[REM] remove obsolete roadmap point
legalsylvain b87b056
[IMP] remove pre-commit exception and fix various style in odoo_patch…
legalsylvain c5eef86
[UPD] Update upgrade_analysis.pot
oca-travis e2fc6c9
[UPD] README.rst
OCA-git-bot 09a8603
[ADD] icon.png
OCA-git-bot 0dffe10
[IMP] openupgrade_records: remove from analysis updating records
MiquelRForgeFlow c8a1681
[FIX] openupgrade_records: _inherits was not being compared
MiquelRForgeFlow d04165f
[IMP] openupgrade_records: compare columns of many2many tables
MiquelRForgeFlow 6391aca
[IMP] openupgrade_records: add _order comparison
MiquelRForgeFlow 830bf87
[IMP] upgrade_analysis: make us of odoorpc/openupgrade master
MiquelRForgeFlow 1b2862f
upgrade_analysis 14.0.2.0.0
OCA-git-bot dddff87
[OU-MIG] upgrade_analysis: add migration scripts
MiquelRForgeFlow 1005081
[UPD] README.rst
OCA-git-bot 9eea0cd
[UPD] Update upgrade_analysis.pot
oca-travis d996299
upgrade_analysis 14.0.2.0.1
OCA-git-bot 8fb079f
[FIX] upgrade_analysis: fix methods related to noupdate data
MiquelRForgeFlow 25e0525
[FIX] upgrade_analysis: truncate upgrade records before generating ne…
MiquelRForgeFlow f4395e0
[UPD] README.rst
OCA-git-bot dfd8ca6
upgrade_analysis 14.0.2.1.0
OCA-git-bot 8aa7a18
[FIX] upgrade_analysis: merged modules affecting noupdate files
MiquelRForgeFlow 0443ee8
[FIX] upgrade_analysis: revert to 'files' approach instead of 'paths'
MiquelRForgeFlow 7c38f6e
[UPD] Update upgrade_analysis.pot
oca-travis f95793e
Added translation using Weblate (French)
Yvesldff a2af382
[IMP] update dotfiles [ci skip]
sbidoul 0b3d30f
Translated using Weblate (French)
Yvesldff 3ff6ca0
[FIX] Other modules upgrade write file full path
Yasaie bd31313
upgrade_analysis 14.0.2.1.1
OCA-git-bot 6df798e
[MIG] upgrade_analysis from 14.0 to 15.0
legalsylvain de83503
[UPD] Update upgrade_analysis.pot
3b2b191
[UPD] README.rst
OCA-git-bot 486b55d
[IMP] upgrade_coverage : generate coverage module file
legalsylvain 965189d
[IMP] upgrade_analysis : prefill status with trivial information
legalsylvain 7b65de3
[REF] in coverage module file, split column into 2. a column that sho…
legalsylvain e63d00f
upgrade_analysis 15.0.1.0.2
OCA-git-bot 6d9e689
[15.0][ADD] link to usage instructions
jcdrubay 41b42ae
[UPD] README.rst
OCA-git-bot 2059b3c
upgrade_analysis 15.0.1.0.3
OCA-git-bot 3431b22
[DOC] upgrade_analysis : update roadmap.rst
legalsylvain b0beaf9
[REF] upgrade_analysis add maintainers
legalsylvain 9309c49
[UPD] README.rst
OCA-git-bot 2e18886
upgrade_analysis 15.0.1.0.4
OCA-git-bot e0295cf
[ADD] upgrade_analysis: generate noupdate_changes for template tag
royle-vietnam 522dbd8
[IMP] upgrade_analysis: log sql_constraints in analysis
MiquelRForgeFlow 6f370f7
[UPD] Update upgrade_analysis.pot
82a229f
[MIG] upgrade_analysis: Migration to 16.0
StefanRijnhart 88726de
[FIX] upgrade_analysis: misleading representation of read/write compu…
StefanRijnhart 383093a
[UPD] Update upgrade_analysis.pot
3603310
[FIX] upgrade_analysis : avoid KeyError "module"
metaminux 0878144
upgrade_analysis 16.0.1.0.1
OCA-git-bot caa8c58
[UPD] README.rst
OCA-git-bot ccc8bd9
[IMP] upgrade_analysis: pre-commit auto fixes
StefanRijnhart 1237990
[MIG] upgrade_analysis: Migration to 17.0
StefanRijnhart dded5ac
[FIX] upgrade_analysis: Proper UI in forms
pedrobaeza 54e3ab3
[FIX] upgrade_analysis: Add to blacklist deprecated modules
pedrobaeza 91a26c0
[REF] upgrade_analysis: allow to set upgrade_path manually
StefanRijnhart 2aa4fda
[REF] upgrade_analysis: increase module description column in generat…
StefanRijnhart 37ff16a
[UPD] Update upgrade_analysis.pot
a32e169
[FIX] upgrade_analysis: fix constraint logging
hbrunn a185ed4
[IMP] upgrade_analysis: black, isort
sergio-teruel 55ca2e9
[MIG] upgrade_analysis: Migration to v18.0
sergio-teruel ae39b4a
[UPD] Update upgrade_analysis.pot
7ea5b77
[BOT] post-merge updates
OCA-git-bot 7c26c17
Update translation files
weblate 933bfe0
[FIX] upgrade_analysis: new modules cannot be merged/renamed in same …
MiquelRForgeFlow 5955b3d
[FIX] upgrade_analysis: exclude OU modules from coverage file
MiquelRForgeFlow 07fd986
[FIX] smart button to open the list of analysis from a config
jcdrubay 2964493
[IMP] upgrade_analysis: Don't reinstall installed modules
pedrobaeza f1c3d07
[FIX] upgrade_analysis: migration errors
MiquelRForgeFlow fd3fc94
[BOT] post-merge updates
OCA-git-bot 1359116
[IMP] upgrade_analysis: don't depend on mako
hbrunn 8ba482e
[BOT] post-merge updates
OCA-git-bot b16b696
[ADD] upgrade_analysis: be more helpful for v18 property conversion
hbrunn af03c8b
[UPD] Update upgrade_analysis.pot
15c08cb
[BOT] post-merge updates
OCA-git-bot d32ea3a
Update translation files
weblate d8b2372
[BOT] post-merge updates
OCA-git-bot c6af6bf
Translated using Weblate (Italian)
mymage af19c55
[FIX] upgrade_analysis: fill upgrade_path
MiquelRForgeFlow 651c971
[BOT] post-merge updates
OCA-git-bot d0ce200
[UPD] Update upgrade_analysis.pot
03a3866
Update translation files
weblate 49e5148
Translated using Weblate (Italian)
mymage c6979df
[FIX] upgrade_analysis: avoid call privatized 'mapped' function.
legalsylvain 4dcb035
[BOT] post-merge updates
OCA-git-bot 3b580a2
[FIX] upgrade_analysis: avoid breaking coverage file
MiquelRForgeFlow a144e2e
[BOT] post-merge updates
OCA-git-bot b42a9e4
[FIX] upgrade_analysis: avoid caring about non stored fields
MiquelRForgeFlow 3e71b4c
[BOT] post-merge updates
OCA-git-bot d8b5f8a
[IMP] upgrade_analysis: handle merge models
MiquelRForgeFlow 1ac7f5d
[FIX] upgrade_analysis: comparing relation
MiquelRForgeFlow 74d50fb
[IMP] upgrade_analysis: better matches and analysis
MiquelRForgeFlow 5493d0d
[FIX] upgrade_analysis: non-stored has to be shown
MiquelRForgeFlow 1856ed0
[BOT] post-merge updates
OCA-git-bot b62ad02
[BOT] post-merge updates
OCA-git-bot 4ce40da
[IMP] upgrade_analysis: consider 'translate' value attribute
MiquelRForgeFlow 2f102c6
[BOT] post-merge updates
OCA-git-bot ba7c274
[IMP] upgrade_analysis: tell user which selection keys were added/rem…
hbrunn 22d057c
[BOT] post-merge updates
OCA-git-bot e924780
[IMP] upgrade_analysis: clarify added/removed selection keys
MiquelRForgeFlow 55d9834
[BOT] post-merge updates
OCA-git-bot 1e5255f
[FIX] upgrade_analysis: sort added & removed keys in selection
MiquelRForgeFlow 77ffabb
[BOT] post-merge updates
OCA-git-bot 5fb0fd3
upgrade_analysis: fix references to tree views
simahawk 0c8526a
[BOT] post-merge updates
OCA-git-bot 25c4ecb
[MIG] upgrade_analysis to v19
hbrunn 4466c81
[UPD] hbrunn's mail address
hbrunn b4f216a
[IMP] upgrade_analysis: compare constraint definitions case insensitive
hbrunn 9959404
[IMP] make general log more clear about obsolete modules
hbrunn 92d7749
[UPD] Update upgrade_analysis.pot
ebf48fe
[BOT] post-merge updates
OCA-git-bot 8ace5e9
[IMP] upgrade_analysis: avoid "empty" analysis files
MiquelRForgeFlow fde46a0
[BOT] post-merge updates
OCA-git-bot efe798d
[FIX] upgrade_analysis: don't generate invalid noupdate xml
hbrunn 2f553cd
[BOT] post-merge updates
OCA-git-bot ee4c735
[FIX] upgrade_analysis: don't generate eval="''" attributes
hbrunn d8d1615
[BOT] post-merge updates
OCA-git-bot 2f09357
[IMP] upgrade_analysis: blacklist more test modules
MiquelRForgeFlow eb712f3
[BOT] post-merge updates
OCA-git-bot dfe63c3
[IMP] upgrade_analysis: generate changes for renamed noupdate records
hbrunn 2e4274e
[BOT] post-merge updates
OCA-git-bot 3aaabf5
[FIX] upgrade_analysis: reset discarded fields to their default, not …
MiquelRForgeFlow 19ef06a
[BOT] post-merge updates
OCA-git-bot 0b3bb11
[FIX] upgrade_analysis: don't reset foreign-module fields on moved no…
MiquelRForgeFlow 077fe4f
[FIX] upgrade_analysis: skip discarded-field reset when value is unch…
MiquelRForgeFlow c96a553
[BOT] post-merge updates
OCA-git-bot 8fcb1a8
[19.0][FIX] upgrade_analysis: update documentation link
iam-piyush 7ed8f8e
[BOT] post-merge updates
OCA-git-bot c589c43
[MIG] upgrade_analysis to v20
hbrunn 6349def
[IMP] upgrade_analysis: speed up xmlid set comparison
hbrunn 8023107
[IMP] upgrade_analysis: support json2 protocol
hbrunn 8260581
[IMP] upgrade_analysis: make hbrunn maintainer
hbrunn 3b09bab
[FIX] upgrade_analysis: patch button_immediate_install
hbrunn 59c408f
[FIX] upgrade_analysis: undo v18-specific treatment of company_depend…
hbrunn c6cdfc0
[IMP] upgrade_analysis: parse Odoo version string with odoorpc.tools.v
hbrunn b67fe67
[19.0][FIX] upgrade_analysis: update usage documentation link
PETRIVAL 195a3b6
[FIX] upgrade_analysis: use odoorpc's api to determine current user
hbrunn File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,6 @@ | ||
| # generated from manifests external_dependencies | ||
| cryptography | ||
| odoorpc | ||
| openupgradelib | ||
| paramiko<4.0.0 | ||
| pysftp |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,137 @@ | ||
| .. image:: https://odoo-community.org/readme-banner-image | ||
| :target: https://odoo-community.org/get-involved?utm_source=readme | ||
| :alt: Odoo Community Association | ||
|
|
||
| ================ | ||
| Upgrade Analysis | ||
| ================ | ||
|
|
||
| .. | ||
| !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! | ||
| !! This file is generated by oca-gen-addon-readme !! | ||
| !! changes will be overwritten. !! | ||
| !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! | ||
| !! source digest: sha256:dfb7b76cc94e27daee6ff65ef90657bb878553637cadfbfd882ce843168afcf9 | ||
| !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! | ||
|
|
||
| .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png | ||
| :target: https://odoo-community.org/page/development-status | ||
| :alt: Beta | ||
| .. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png | ||
| :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html | ||
| :alt: License: AGPL-3 | ||
| .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fserver--tools-lightgray.png?logo=github | ||
| :target: https://github.com/OCA/server-tools/tree/20.0/upgrade_analysis | ||
| :alt: OCA/server-tools | ||
| .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png | ||
| :target: https://translation.odoo-community.org/projects/server-tools-20-0/server-tools-20-0-upgrade_analysis | ||
| :alt: Translate me on Weblate | ||
| .. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png | ||
| :target: https://runboat.odoo-community.org/builds?repo=OCA/server-tools&target_branch=20.0 | ||
| :alt: Try me on Runboat | ||
|
|
||
| |badge1| |badge2| |badge3| |badge4| |badge5| | ||
|
|
||
| This module provides the tool to generate the database analysis files | ||
| that indicate how the Odoo data model and module data have changed | ||
| between two versions of Odoo. Database analysis files for the core | ||
| modules are included in the OpenUpgrade distribution so as a migration | ||
| script developer you will not usually need to use this tool yourself. If | ||
| you do need to run your analysis of a custom set of modules, please | ||
| refer to the documentation here: | ||
| https://oca.github.io/OpenUpgrade/070_migration_files.html#generate-the-difference-analysis-files | ||
|
|
||
| This module is just a tool, a continuation of the old | ||
| openupgrade_records in OpenUpgrade in previous versions. It's not | ||
| recommended to have this module in a production database. | ||
|
|
||
| **Table of contents** | ||
|
|
||
| .. contents:: | ||
| :local: | ||
|
|
||
| Usage | ||
| ===== | ||
|
|
||
| `Usage | ||
| instructions <https://oca.github.io/OpenUpgrade/070_migration_files.html#generate-the-difference-analysis-files>`__ | ||
|
|
||
| Known issues / Roadmap | ||
| ====================== | ||
|
|
||
| - Log removed modules in the module that owned them (#468) | ||
| - Detect renamed many2many tables (#213) | ||
| - Make sure that the ``migration_analysis.txt`` file is always generated | ||
| in all cases. (See: | ||
| https://github.com/OCA/OpenUpgrade/pull/3209#issuecomment-1157449981) | ||
|
|
||
| Bug Tracker | ||
| =========== | ||
|
|
||
| Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues>`_. | ||
| In case of trouble, please check there if your issue has already been reported. | ||
| If you spotted it first, help us to smash it by providing a detailed and welcomed | ||
| `feedback <https://github.com/OCA/server-tools/issues/new?body=module:%20upgrade_analysis%0Aversion:%2020.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. | ||
|
|
||
| Do not contact contributors directly about support or help with technical issues. | ||
|
|
||
| Credits | ||
| ======= | ||
|
|
||
| Authors | ||
| ------- | ||
|
|
||
| * Therp BV | ||
| * Opener B.V. | ||
| * GRAP | ||
|
|
||
| Contributors | ||
| ------------ | ||
|
|
||
| - Stefan Rijnhart <stefan@opener.amsterdam> | ||
|
|
||
| - Holger Brunn <mail@hunki-enterprises.com> | ||
|
|
||
| - Ferdinand Gassauer <gass@cc-l-12.chircar.at> | ||
|
|
||
| - Florent Xicluna <florent.xicluna@gmail.com> | ||
|
|
||
| - Miquel Raïch <miquel.raich@forgeflow.com> | ||
|
|
||
| - Sylvain LE GAL <https://twitter.com/legalsylvain> | ||
|
|
||
| - `Tecnativa <https://www.tecnativa.com>`__: | ||
|
|
||
| - Pedro M. Baeza | ||
| - Sergio Teruel | ||
|
|
||
| Maintainers | ||
| ----------- | ||
|
|
||
| This module is maintained by the OCA. | ||
|
|
||
| .. image:: https://odoo-community.org/logo.png | ||
| :alt: Odoo Community Association | ||
| :target: https://odoo-community.org | ||
|
|
||
| OCA, or the Odoo Community Association, is a nonprofit organization whose | ||
| mission is to support the collaborative development of Odoo features and | ||
| promote its widespread use. | ||
|
|
||
| .. |maintainer-StefanRijnhart| image:: https://github.com/StefanRijnhart.png?size=40px | ||
| :target: https://github.com/StefanRijnhart | ||
| :alt: StefanRijnhart | ||
| .. |maintainer-legalsylvain| image:: https://github.com/legalsylvain.png?size=40px | ||
| :target: https://github.com/legalsylvain | ||
| :alt: legalsylvain | ||
| .. |maintainer-hbrunn| image:: https://github.com/hbrunn.png?size=40px | ||
| :target: https://github.com/hbrunn | ||
| :alt: hbrunn | ||
|
|
||
| Current `maintainers <https://odoo-community.org/page/maintainer-role>`__: | ||
|
|
||
| |maintainer-StefanRijnhart| |maintainer-legalsylvain| |maintainer-hbrunn| | ||
|
|
||
| This module is part of the `OCA/server-tools <https://github.com/OCA/server-tools/tree/20.0/upgrade_analysis>`_ project on GitHub. | ||
|
|
||
| You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| from . import odoo_patch | ||
| from . import models | ||
| from . import wizards | ||
| from . import blacklist | ||
| from . import compare | ||
| from . import upgrade_log |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,29 @@ | ||
| # Copyright 2011-2015 Therp BV <https://therp.nl> | ||
| # Copyright 2016 Opener B.V. <https://opener.am> | ||
| # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). | ||
| { | ||
| "name": "Upgrade Analysis", | ||
| "summary": "Performs a difference analysis between modules" | ||
| " installed on two different Odoo instances", | ||
| "version": "20.0.1.0.0", | ||
| "category": "Migration", | ||
| "author": "Therp BV, Opener B.V., GRAP, Odoo Community Association (OCA)", | ||
| "maintainers": ["StefanRijnhart", "legalsylvain", "hbrunn"], | ||
| "website": "https://github.com/OCA/server-tools", | ||
| "data": [ | ||
| "templates/module_coverage_template.xml", | ||
| "security/ir.access.csv", | ||
| "views/menu.xml", | ||
| "views/view_upgrade_comparison_config.xml", | ||
| "views/view_upgrade_analysis.xml", | ||
| "views/view_upgrade_record.xml", | ||
| "wizards/view_upgrade_generate_record_wizard.xml", | ||
| "wizards/view_upgrade_install_wizard.xml", | ||
| ], | ||
| "installable": True, | ||
| "depends": ["web"], | ||
| "external_dependencies": { | ||
| "python": ["odoorpc", "openupgradelib"], | ||
| }, | ||
| "license": "AGPL-3", | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| BLACKLIST_MODULES = [ | ||
| "payment_alipay", | ||
| "payment_ogone", | ||
| "payment_payulatam", | ||
| "payment_payumoney", | ||
| ] | ||
|
|
||
| # the hw_* modules are not affected by a migration as they don't | ||
| # contain any ORM functionality, but they do start up threads that | ||
| # delay the process and spit out annoying log messages continuously. | ||
|
|
||
| # We also don't want to analyze tests modules | ||
| BLACKLIST_MODULES_STARTS_WITH = ["hw_", "test_", "l10n_test_"] | ||
|
|
||
| BLACKLIST_MODULES_ENDS_WITH = ["_test", "_tests"] |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.