{"id":22907337,"url":"https://github.com/xiyusullos/umm","last_synced_at":"2025-05-08T22:18:02.307Z","repository":{"id":62586236,"uuid":"324199537","full_name":"xiyusullos/umm","owner":"xiyusullos","description":"A toolkit to manager the fastest mirror of various tools, such as pip, npm, docker, golang, composer and etc.","archived":false,"fork":false,"pushed_at":"2024-08-08T09:13:06.000Z","size":52,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-08T22:17:50.033Z","etag":null,"topics":["brew","composer","docker","fast","golang","homebrew","linuxbrew","mirror","npm","pip","repository","toolkit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xiyusullos.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-24T16:49:11.000Z","updated_at":"2024-08-08T09:13:10.000Z","dependencies_parsed_at":"2022-11-03T22:09:07.448Z","dependency_job_id":null,"html_url":"https://github.com/xiyusullos/umm","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiyusullos%2Fumm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiyusullos%2Fumm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiyusullos%2Fumm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiyusullos%2Fumm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xiyusullos","download_url":"https://codeload.github.com/xiyusullos/umm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253155004,"owners_count":21862625,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brew","composer","docker","fast","golang","homebrew","linuxbrew","mirror","npm","pip","repository","toolkit"],"created_at":"2024-12-14T03:14:35.939Z","updated_at":"2025-05-08T22:18:02.251Z","avatar_url":"https://github.com/xiyusullos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# umm: yoUr Mirror Manager\n\nA toolkit to manager the fastest mirror of various tools, such as pip, npm, composer and etc.\n\n## Table of Contents\n\n   * [umm: yoUr Mirror Manager](#umm-your-mirror-manager)\n      * [Features](#features)\n      * [Installation](#installation)\n      * [Usage](#usage)\n         * [Show umm help](#show-umm-help)\n         * [Manage pip](#manage-pip)\n            * [Show umm pip help](#show-umm-pip-help)\n            * [List all available mirrors of pip](#list-all-available-mirrors-of-pip)\n            * [Use the given mirror for pip](#use-the-given-mirror-for-pip)\n            * [Show current mirror of pip](#show-current-mirror-of-pip)\n         * [Manage npm](#manage-npm)\n            * [Show umm npm help](#show-umm-npm-help)\n            * [List all available mirrors of npm](#list-all-available-mirrors-of-npm)\n            * [Use the given mirror for npm](#use-the-given-mirror-for-npm)\n            * [Show current mirror of npm](#show-current-mirror-of-npm)\n      * [How to test in local](#how-to-test-in-local)\n\n## Features\n\nWe are going to support to manage the mirror of following tools:\n- [x] pip\n- [x] npm\n- [x] composer\n- [x] homebrew\n- [x] linuxbrew\n- [x] golang\n- [ ] docker\n- [ ] ubuntu\n- [ ] centos\n- [ ] julia\n- [ ] etc.\n\n## Installation\n\n```bash\n# pip install -i https://pypi.tuna.tsinghua.edu.cn/simple umm\npip install umm\n```\n## Upgrade\n\n```bash\npip install -U umm\n```\n\n## Usage\n\n### Show `umm` help\n\n```bash\numm\n```\nor\n```bash\numm --ehlp\n```\n\nOutput\n```\nUsage: umm [OPTIONS] COMMAND [ARGS]...\n\n  A toolkit to manager the fastest mirror of various tools, such as pip,\n  npm, composer and etc.\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  npm  Manage npm mirrors.\n  pip  Manage pip mirrors.\n  v    Show umm version.\n```\n\n### Manage `pip`\n\n#### Show `umm pip` help\n\n```bash\numm pip\n```\nor\n```bash\numm pip --ehlp\n```\n\nOutput\n```\nUsage: umm pip [OPTIONS] COMMAND [ARGS]...\n\n  Manage pip mirrors.\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  ls   List all available mirrors\n  now  Show current mirror.\n  use  Use the given mirror.\n```\n\n#### List all available mirrors of `pip`\n\n```bash\numm pip ls\n```\n\nOutput\n```\no               https://pypi.python.org/simple/\ntuna            https://pypi.tuna.tsinghua.edu.cn/simple\ndouban          http://pypi.douban.com/simple/\naliyun          https://mirrors.aliyun.com/pypi/simple/\nustc            https://mirrors.ustc.edu.cn/pypi/web/simple\n```\n#### Use the given mirror for `pip`\n\nFor example, use the **tuna** mirror.\n\n```bash\numm pip use tuna\n```\n\n#### Show current mirror of `pip`\n\n```bash\numm pip now\n```\n\nOutput\n```\ntuna            https://pypi.tuna.tsinghua.edu.cn/simple\n```\n\n\n\n### Manage `npm`\n\n#### Show `umm npm` help\n\n```bash\numm npm\n```\nor\n```bash\numm npm --ehlp\n```\n\nOutput\n```\nUsage: umm npm [OPTIONS] COMMAND [ARGS]...\n\n  Manage npm mirrors.\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  ls   List all available mirrors.\n  now  Show current using mirror.\n  use  Use the given mirror.\n```\n\n#### List all available mirrors of `npm`\n\n```bash\numm npm ls\n```\n\nOutput\n```\n  [npm] name      url\n------------------------------------------------------------\n* o               https://registry.npmjs.org/\n  cnpm            http://r.cnpmjs.org/\n  taobao          https://registry.npm.taobao.org/\n  nj              https://registry.nodejitsu.com/\n  npmMirror       https://skimdb.npmjs.com/registry/\n  edunpm          http://registry.enpmjs.org/\n```\n#### Use the given mirror for `npm`\n\nFor example, use the **tabao** mirror.\n\n```bash\numm npm use taobao\n```\n\n#### Show current mirror of `npm`\n\n```bash\numm npm now\n```\n\nOutput\n```\ntaobao          https://registry.npm.taobao.org/\n```\n\n## How to test\n\n### install locally\n\nOnce your developed a while and want to test the umm, your have two ways to test:\n\n1. install this package in your local via:\n\n```bash\npip install --editable .\n```\n2. or, directly run the python file via:\n\n```bash\npython -m umm\n```\n\n### run the test\n\nMake sure you have installed `pytest`\n\n```bash\ncd umm/\nexport PYTHONPATH=src\npytest\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiyusullos%2Fumm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxiyusullos%2Fumm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiyusullos%2Fumm/lists"}