{"id":15431121,"url":"https://github.com/yaegassy/coc-black-formatter","last_synced_at":"2025-04-19T17:10:22.310Z","repository":{"id":179301307,"uuid":"658419956","full_name":"yaegassy/coc-black-formatter","owner":"yaegassy","description":"microsoft/vscode-black-formatter's langauge server extension for coc.nvim","archived":false,"fork":false,"pushed_at":"2025-03-23T11:14:53.000Z","size":159,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-11T15:04:07.619Z","etag":null,"topics":["black","coc","coc-black-formatter","coc-extensions","coc-nvim","neovim","python","python3","vim"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@yaegassy/coc-black-formatter","language":"TypeScript","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/yaegassy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-25T17:30:23.000Z","updated_at":"2025-03-23T11:14:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"135dfacb-6c13-4f97-97df-4774fd21ea5a","html_url":"https://github.com/yaegassy/coc-black-formatter","commit_stats":{"total_commits":43,"total_committers":1,"mean_commits":43.0,"dds":0.0,"last_synced_commit":"3150b134064f3d4764f708547d86bcb397814e08"},"previous_names":["yaegassy/coc-black-formatter"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaegassy%2Fcoc-black-formatter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaegassy%2Fcoc-black-formatter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaegassy%2Fcoc-black-formatter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaegassy%2Fcoc-black-formatter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yaegassy","download_url":"https://codeload.github.com/yaegassy/coc-black-formatter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249746041,"owners_count":21319581,"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":["black","coc","coc-black-formatter","coc-extensions","coc-nvim","neovim","python","python3","vim"],"created_at":"2024-10-01T18:20:37.031Z","updated_at":"2025-04-19T17:10:22.291Z","avatar_url":"https://github.com/yaegassy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# coc-black-formatter\n\n[microsoft/vscode-black-formatter](https://github.com/microsoft/vscode-black-formatter)'s langauge server extension for [coc.nvim](https://github.com/neoclide/coc.nvim).\n\n## Install\n\n**CocInstall**:\n\n```\n:CocInstall @yaegassy/coc-black-formatter\n```\n\n**When using a plugin manager, etc**:\n\n\u003e e.g. vim-plug\n\n```vim\nPlug 'yaegassy/coc-black-formatter', {'do': 'yarn install --frozen-lockfile'}\n```\n\n## Server Install\n\n[coc-black-formatter](https://github.com/yaegassy/coc-black-formatter/) allows you to create an extension-only \"venv\" and install `microsoft/vscode-black-formatter's langauge server`.\n\nWhen using [coc-black-formatter](https://github.com/yaegassy/coc-black-formatter/) for the first time, if `microsoft/vscode-black-formatter's langauge server` is not present in the runtime environment, you will be prompted to do a built-in install.\n\nTo use the built-in installation feature, execute the following command.\n\n```vim\n:CocCommand black-formatter.installServer\n```\n\n## Note\n\n### Detecting the \"black\" command from the execution environment\n\nThe `black` command used by `microsoft/vscode-black-formatter's langauge server` is the `black` command of the python environment installed with `microsoft/vscode-black-formatter's langauge server`.\n\nTo use the `black` command installed in the virtual environment of a project created by `venv`, `poetry`, etc., `black-formatter.path` must be set to an absolute path.\n\n[coc-black-formatter](https://github.com/yaegassy/coc-black-formatter/) adds the feature to automatically detect `black` commands in the execution environment and use them in `microsoft/vscode-black-formatter's langauge server`.\n\nIf you do not need this feature, set `black-formatter.useDetectBlackCommand` to `false`.\n\n**coc-settings.json**:\n\n```jsonc\n{\n  \"black-formatter.useDetectBlackCommand\": false\n}\n```\n\n### When used with other coc-extensions for python that provide formatting feature\n\nFor example, [coc-pyright](https://github.com/fannheyward/coc-pyright) provides a formatting feature.\n\nIf [coc-black-formatter](https://github.com/yaegassy/coc-black-formatter) and `coc-pyright` are used together, the `coc-pyright` formatting feature should be disabled.\n\n**coc-settings.json**:\n\n```jsonc\n{\n  \"python.formatting.provider\": \"none\",\n}\n```\n\n## Configuration options\n\n- `black-formatter.enable`: Enable coc-black-formatter extension, default: `true`\n- `black-formatter.useDetectBlackCommand`: Automatically detects the black command in the execution environment and sets `black-formatter.path`, default: `true`\n- `black-formatter.builtin.pythonPath`: Python 3.x path (Absolute path) to be used for built-in install, default: `\"\"`\n- `black-formatter.trace.server`: Traces the communication between coc.nvim and the language server, default: `\"off\"`\n\nOther settings have the same configuration as [microsoft/vscode-black-formatter](https://github.com/microsoft/vscode-black-formatter).\n\n## Commands\n\n- `black-formatter.restart`: Restart Server\n- `black-formatter.installServer`: Install Server\n- `black-formatter.showOutput`: Show output channel\n- `black-formatter.version`: Show the version of the server installed by the extension\n\n## Thanks\n\n- [microsoft/vscode-black-formatter](https://github.com/microsoft/vscode-black-formatter)\n\n## License\n\nMIT\n\n---\n\n\u003e This extension is built with [create-coc-extension](https://github.com/fannheyward/create-coc-extension)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyaegassy%2Fcoc-black-formatter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyaegassy%2Fcoc-black-formatter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyaegassy%2Fcoc-black-formatter/lists"}