function main() { $args = $_SERVER['argv']; $boost_root = null; switch (count($args)) { case 2: $boost_root = $args[1]; break; default: echo "Usage: create-module-metadata.php boost_root\n"; exit(1); } $library_details = BoostLibraries::from_xml_file(__DIR__ . '/../doc/libraries.xml')->get_for_version(BoostVersion::develop()); $super_project = new BoostSuperProject($boost_root); $git_submodules = $super_project->get_modules(); // Split the libraries up into modules. $libraries_by_module = array(); foreach ($library_details as $library) { $module = $library['module']; if (!isset($git_submodules[$module])) { echo "Unknown module: {$module}\n"; continue; } if (isset($library['documentation'])) { $doc_url = $library['documentation']; $module_base = $git_submodules[$module]['path']; if ($doc_url == $module_base) { $doc_url = ''; } else { if (strpos($doc_url, "{$module_base}/") === 0) { $doc_url = substr($doc_url, strlen("{$module_base}/")); } else { $doc_url = "/{$doc_url}"; } } if (!$doc_url) { unset($library['documentation']); } else { $library['documentation'] = $doc_url; } } $libraries_by_module[$module][] = $library; } // Write the module metadata foreach ($libraries_by_module as $module => $libraries) { $module_libraries = BoostLibraries::from_array($libraries); $module_dir = "{$boost_root}/{$git_submodules[$module]['path']}"; $meta_dir = "{$module_dir}/meta"; $meta_file = "{$module_dir}/meta/libraries.json"; if (!is_dir($module_dir)) { echo "Module '{$module}' doesn't exist at '{$module_dir}'\n"; continue; } if (!is_dir($meta_dir)) { mkdir($meta_dir); } file_put_contents($meta_file, $module_libraries->to_json(array('boost-version', 'update-version', 'module')) . "\n"); } }
function main() { $args = $_SERVER['argv']; $location = null; switch (count($args)) { case 2: $location = $args[1]; break; default: echo "Usage: backdate-maintainers.php location\n"; exit(1); } // Get the library data, so that it can be updated with maintainers. // In case you're wondering why the result from get_for_version doesn't // use 'key' as its key, it's for historical reasons I think, might be // fixable. $libraries = BoostLibraries::from_xml_file(__DIR__ . '/../doc/libraries.xml'); $unknown_libs = array(); foreach (BoostSuperProject::run_process("cd \"{$location}\" && git tag") as $tag) { if (preg_match('@^boost-1\\.\\d+\\.\\d+$@', $tag)) { $library_details = $libraries->get_for_version($tag, null, 'BoostLibraries::filter_all'); $libs_index = array(); foreach ($library_details as $index => $details) { $libs_index[$details['key']] = $index; } foreach (BoostMaintainers::read_from_text(git_file($location, $tag, 'libs/maintainers.txt'))->maintainers as $key => $lib_maintainers) { if (isset($libs_index[$key])) { $index = $libs_index[$key]; $library_details[$index]['maintainers'] = $lib_maintainers; } else { $unknown_libs[$key][] = $tag; } } $update = array_map(function ($lib) { return new BoostLibrary($lib); }, $library_details); $libraries->update($tag, $update); } } file_put_contents(dirname(__FILE__) . '/../doc/libraries.xml', $libraries->to_xml()); $names = array_keys($unknown_libs); sort($names); echo "Unable to find libraries:\n"; foreach ($names as $lib) { echo "{$lib} from: " . implode(', ', $unknown_libs[$lib]) . "\n"; } }
function main() { $args = $_SERVER['argv']; if (count($args) != 3) { echo "Usage: update-maintainers.php location version\n"; exit(1); } $location = $args[1]; $version = $args[2]; $libraries = BoostLibraries::from_xml_file(__DIR__ . '/../doc/libraries.xml'); $unknown_libs = array(); $maintainers = BoostMaintainers::read_from_text(file($location . '/libs/maintainers.txt')); $library_details = $libraries->get_for_version($version, null); $libs_index = array(); foreach ($library_details as $index => $details) { if (isset($details['maintainers'])) { $maintainers->update_maintainer($details['key'], $details['maintainers']); } } file_put_contents($location . '/libs/maintainers.txt', $maintainers->write_to_text()); }
function main() { $options = BoostSiteTools\CommandLineOptions::parse("Usage: {} location version"); if (count($options->positional) != 2) { echo $options->usage_message(); exit(1); } $location = $options->positional[0]; $version = $options->positional[1]; $libraries = BoostLibraries::from_xml_file(__DIR__ . '/../doc/libraries.xml'); $unknown_libs = array(); $maintainers = BoostMaintainers::read_from_text(file($location . '/libs/maintainers.txt')); // TODO: Want to include hidden libraries here. $library_details = $libraries->get_for_version($version, null); $libs_index = array(); foreach ($library_details as $index => $details) { if (isset($details['maintainers'])) { $maintainers->update_maintainer($details['key'], $details['maintainers']); } } file_put_contents($location . '/libs/maintainers.txt', $maintainers->write_to_text()); }
/** * */ static function load() { return USE_SERIALIZED_INFO ? unserialize(file_get_contents(dirname(__FILE__) . '/../../generated/libraries.txt')) : BoostLibraries::from_xml_file(dirname(__FILE__) . '/../../doc/libraries.xml'); }
function main() { global $quiet; $options = BoostSiteTools\CommandLineOptions::parse(UPDATE_DOC_LIST_USAGE, array('quiet' => false)); $quiet = $options->flags['quiet']; $location = null; $version = null; switch (count($options->positional)) { case 2: $version = $options->positional[1]; case 1: $location = $options->positional[0]; case 0: break; default: echo $options->usage_message(); exit(1); } if ($version) { // BoostVersion dies if version is invalid. $version = BoostVersion::from($version); } $libs = BoostLibraries::from_xml_file(dirname(__FILE__) . '/../doc/libraries.xml'); $updates = array(); if ($location) { $real_location = realpath($location); if ($real_location && !is_dir($real_location)) { echo "Not a directory: {$location}\n"; exit(1); } $location = $real_location; // If this is not a git repo. // TODO: Don't output stderr. exec("cd \"{$location}\" && git rev-parse --git-dir", $output, $return_var); if ($return_var != 0) { if (!$version || !$version->is_numbered_release()) { echo "Error: Release version required for release.\n"; exit(1); } $updates[(string) $version] = read_metadata_from_filesystem($location, $version); } else { if (get_bool_from_array(BoostSuperProject::run_process("cd '{$location}' && git rev-parse --is-bare-repository"))) { if ($version) { $updates[(string) $version] = read_metadata_from_git($location, $version); } else { $updates[(string) 'master'] = read_metadata_from_git($location, 'master'); $updates[(string) 'develop'] = read_metadata_from_git($location, 'develop'); } } else { // TODO: Could get version from the branch in a git checkout. if (!$version) { echo "Error: Version required for local tree.\n"; exit(1); } $updates[(string) $version] = read_metadata_from_filesystem($location, $version); } } } if ($updates) { foreach ($updates as $update_version => $update) { $libs->update($update_version, $update); } } else { $libs->update(); } if (!$quiet) { echo "Writing to disk\n"; } file_put_contents(dirname(__FILE__) . '/../doc/libraries.xml', $libs->to_xml()); $libs->squash_name_arrays(); file_put_contents(dirname(__FILE__) . '/../generated/libraries.txt', serialize($libs)); }
function main() { $args = $_SERVER['argv']; $location = null; $version = null; switch (count($args)) { case 3: $version = $args[2]; case 2: $location = $args[1]; case 1: break; default: echo "Usage: update-doc-list.php [path] [version]\n"; exit(1); } if ($version) { // BoostVersion dies if version is invalid. $version = BoostVersion::from($version); } $libs = BoostLibraries::from_xml_file(dirname(__FILE__) . '/../doc/libraries.xml'); $updates = array(); if ($location) { $real_location = realpath($location); if ($real_location && !is_dir($real_location)) { echo "Not a directory: {$location}\n"; exit(1); } $location = $real_location; // If this is not a git repo. // TODO: Don't output stderr. exec("cd \"{$location}\" && git rev-parse --git-dir", $output, $return_var); if ($return_var != 0) { if (!$version || !$version->is_numbered_release()) { echo "Error: Release version required for release.\n"; exit(1); } $updates[(string) $version] = read_metadata_from_release($location, $version, $libs); } else { if (get_bool_from_array(BoostSuperProject::run_process("cd '{$location}' && git rev-parse --is-bare-repository"))) { if ($version) { $updates[(string) $version] = read_metadata_from_git($location, $version); } else { $updates[(string) 'master'] = read_metadata_from_git($location, 'master'); $updates[(string) 'develop'] = read_metadata_from_git($location, 'develop'); } } else { // TODO: Could get version from the branch in a git checkout. if (!$version) { echo "Error: Version required for local tree.\n"; exit(1); } $updates[(string) $version] = read_metadata_from_local_clone($location, $version); } } } if ($updates) { foreach ($updates as $update_version => $update) { $libs->update($update_version, $update); } } else { $libs->update(); } echo "Writing to disk\n"; file_put_contents(dirname(__FILE__) . '/../doc/libraries.xml', $libs->to_xml()); $libs->squash_name_arrays(); file_put_contents(dirname(__FILE__) . '/../generated/libraries.txt', serialize($libs)); }