[](https://code.mp)
[](https://github.com/hexedtech/codemp/actions)
[](https://docs.rs/codemp/)
[](https://crates.io/crates/codemp)
[](https://gitter.im/hexedtech/codemp)
[](https://github.com/hexedtech/codemp/commits/dev/)
[](https://github.com/hexedtech/codemp/releases/tag/v0.8.4)
> `codemp` is a **collaborative** text editing solution to work remotely.
It seamlessly integrates in your editor providing remote cursors and instant text synchronization,
as well as a remote virtual workspace for you and your team.
> `codemp` is build with state-of-the-art CRDT technology, guaranteeing eventual consistency.
This means that all agents are guaranteed to converge to a consistent state once all changes are received,
_no matter their order or timing_, while preserving each operation's original intention. On top of this
baseline, `codemp`'s protocol is optimized for speed and low network footprint, meaning even slow
connections or dated hardware can provide stable real-time editing.
The full documentation is available on [docs.rs](https://docs.rs/codemp/).
# Usage
`codemp` is primarily used as a plugin in your editor of choice.
## Installation
> [!IMPORTANT]
> The editor plugins are in active development. Expect frequent changes.
`codemp` is available as a plugin for a growing number of text editors. Currently we support:
- [NeoVim](https://github.com/hexedtech/codemp-nvim)
- [VSCode](https://github.com/hexedtech/codemp-vscode)
- [Sublime Text](https://github.com/hexedtech/codemp-sublime)
- [IntelliJ Platform](https://github.com/hexedtech/codemp-intellij)
## Registration
The `codemp` protocol is [openly available](https://github.com/hexedtech/codemp-proto/) and servers may be freely developed with it.
A reference instance is provided by hexed.technology at [code.mp](https://code.mp). You may create an account for it [here](https://code.mp/signup).
During the initial closed beta, registrations will require an invite code. Get in contact if interested.
An open beta is going to follow with free access to a single workspace per user.
After such period, [code.mp](https://code.mp) will switch to a subscription-based model.
# Development
This is the main client library for `codemp`. It provides a batteries-included fully-featured `Client`, managed by the library itself, and exposes a number of functions to interact with it. The host program can obtain a `Client` handle by connecting, and from that reference can retrieve every other necessary component.
`codemp` is primarily a rlib and can be used as such, but is also available in other languages via FFI.
Adding a dependency on `codemp` is **easy**:
### From Rust
Just `cargo add codemp` and check the docs for some examples.
### From supported languages
We provide first-class bindings for these other programming languages:
| | Build Status | Package | Build Instructions |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| JavaScript | [](https://github.com/hexedtech/codemp/actions/workflows/javascript.yml) | [](https://npmjs.org/package/codemp) | [README](./dist/README.md#javascript) |
| Python | [](https://github.com/hexedtech/codemp/actions/workflows/python.yml) | [](https://pypi.org/project/codemp) | [README](./dist/README.md#python) |
| Java | [](https://github.com/hexedtech/codemp/actions/workflows/java.yml) | [](https://central.sonatype.com/artifact/mp.code/codemp) | [README](./dist/README.md#java) |
| Lua | [](https://github.com/hexedtech/codemp/actions/workflows/lua.yml) | [](https://luarocks.org/modules/alemi/codemp) | [README](./dist/README.md#lua) |
As a design philosophy, our binding APIs attempt to perfectly mimic their Rust counterparts, so the main documentation can still be referenced as source of truth.
Refer to specific language documentation for specifics, differences and quirks.
### From other languages
> [!IMPORTANT]
> The common C bindings are not available yet!
Any other language with C FFI capabilities will be able to use `codemp` via its bare C bindings.
This may be more complex and may require wrapping the native calls underneath.
# Get in Touch
We love to hear back from users! Be it to give feedback, propose new features or highlight bugs, don't hesitate to reach out!
## Contacts
We have a public [Gitter](https://gitter.im) room available on [gitter.im/hexedtech/codemp](https://gitter.im/hexedtech/codemp).
It's possible to freely browse the room history, but to send new messages it will be necessary to sign in with your GitHub account.
If you have a [Matrix](https://matrix.org) account, you can join the gitter room directly at [#hexedtech_codemp:gitter.im](https://matrix.to/#/#hexedtech_codemp:gitter.im)
## Contributing
If you find bugs or would like to see new features implemented, be sure to open an issue on this repository.
In case you wish to contribute code, that's great! We love external contributions, feel free to open a PR!
Raw data
{
"_id": null,
"home_page": "https://code.mp",
"name": "codemp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "cschen <cschen@codemp.dev>",
"keywords": "codemp, cooperative, rust, python",
"author": "alemi <me@alemi.dev>, zaaarf <me@zaaarf.foo>, frelodev <frelodev@gmail.com>, cschen <cschen@codemp.dev>",
"author_email": "cschen <cschen@codemp.dev>, alemi <me@alemi.dev>, zaaarf <me@zaaarf.foo>, frelodev <frelodev@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/bb/39/d8edad1f23474d8d1d5cf333b073144f9857f6915695ccde1bbd849e2320/codemp-0.8.4.tar.gz",
"platform": null,
"description": "[](https://code.mp)\n\n[](https://github.com/hexedtech/codemp/actions)\n[](https://docs.rs/codemp/)\n[](https://crates.io/crates/codemp)\n[](https://gitter.im/hexedtech/codemp)\n[](https://github.com/hexedtech/codemp/commits/dev/)\n[](https://github.com/hexedtech/codemp/releases/tag/v0.8.4)\n\n> `codemp` is a **collaborative** text editing solution to work remotely.\n\nIt seamlessly integrates in your editor providing remote cursors and instant text synchronization,\nas well as a remote virtual workspace for you and your team.\n\n> `codemp` is build with state-of-the-art CRDT technology, guaranteeing eventual consistency.\n\nThis means that all agents are guaranteed to converge to a consistent state once all changes are received,\n_no matter their order or timing_, while preserving each operation's original intention. On top of this\nbaseline, `codemp`'s protocol is optimized for speed and low network footprint, meaning even slow\nconnections or dated hardware can provide stable real-time editing.\n\nThe full documentation is available on [docs.rs](https://docs.rs/codemp/).\n\n# Usage\n`codemp` is primarily used as a plugin in your editor of choice.\n\n## Installation\n> [!IMPORTANT]\n> The editor plugins are in active development. Expect frequent changes.\n\n`codemp` is available as a plugin for a growing number of text editors. Currently we support:\n - [NeoVim](https://github.com/hexedtech/codemp-nvim)\n - [VSCode](https://github.com/hexedtech/codemp-vscode)\n - [Sublime Text](https://github.com/hexedtech/codemp-sublime)\n - [IntelliJ Platform](https://github.com/hexedtech/codemp-intellij)\n\n## Registration\nThe `codemp` protocol is [openly available](https://github.com/hexedtech/codemp-proto/) and servers may be freely developed with it.\n\nA reference instance is provided by hexed.technology at [code.mp](https://code.mp). You may create an account for it [here](https://code.mp/signup).\nDuring the initial closed beta, registrations will require an invite code. Get in contact if interested.\n\nAn open beta is going to follow with free access to a single workspace per user.\nAfter such period, [code.mp](https://code.mp) will switch to a subscription-based model.\n\n# Development\nThis is the main client library for `codemp`. It provides a batteries-included fully-featured `Client`, managed by the library itself, and exposes a number of functions to interact with it. The host program can obtain a `Client` handle by connecting, and from that reference can retrieve every other necessary component.\n\n`codemp` is primarily a rlib and can be used as such, but is also available in other languages via FFI.\n\nAdding a dependency on `codemp` is **easy**:\n\n### From Rust\nJust `cargo add codemp` and check the docs for some examples.\n\n### From supported languages\nWe provide first-class bindings for these other programming languages:\n\n\n| | Build Status | Package | Build Instructions |\n| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |\n| JavaScript | [](https://github.com/hexedtech/codemp/actions/workflows/javascript.yml) | [](https://npmjs.org/package/codemp) | [README](./dist/README.md#javascript) |\n| Python | [](https://github.com/hexedtech/codemp/actions/workflows/python.yml) | [](https://pypi.org/project/codemp) | [README](./dist/README.md#python) |\n| Java | [](https://github.com/hexedtech/codemp/actions/workflows/java.yml) | [](https://central.sonatype.com/artifact/mp.code/codemp) | [README](./dist/README.md#java) |\n| Lua | [](https://github.com/hexedtech/codemp/actions/workflows/lua.yml) | [](https://luarocks.org/modules/alemi/codemp) | [README](./dist/README.md#lua) |\n\n\n\nAs a design philosophy, our binding APIs attempt to perfectly mimic their Rust counterparts, so the main documentation can still be referenced as source of truth.\nRefer to specific language documentation for specifics, differences and quirks.\n\n### From other languages\n> [!IMPORTANT]\n> The common C bindings are not available yet!\n\nAny other language with C FFI capabilities will be able to use `codemp` via its bare C bindings.\nThis may be more complex and may require wrapping the native calls underneath.\n\n# Get in Touch\nWe love to hear back from users! Be it to give feedback, propose new features or highlight bugs, don't hesitate to reach out!\n\n## Contacts\nWe have a public [Gitter](https://gitter.im) room available on [gitter.im/hexedtech/codemp](https://gitter.im/hexedtech/codemp).\nIt's possible to freely browse the room history, but to send new messages it will be necessary to sign in with your GitHub account.\n\nIf you have a [Matrix](https://matrix.org) account, you can join the gitter room directly at [#hexedtech_codemp:gitter.im](https://matrix.to/#/#hexedtech_codemp:gitter.im)\n\n## Contributing\nIf you find bugs or would like to see new features implemented, be sure to open an issue on this repository.\n\nIn case you wish to contribute code, that's great! We love external contributions, feel free to open a PR!\n\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "code multiplexer",
"version": "0.8.4",
"project_urls": {
"Homepage": "https://code.mp",
"repository": "https://github.com/hexedtech/codemp.git"
},
"split_keywords": [
"codemp",
" cooperative",
" rust",
" python"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "93361a314d552c252536b275ef7655613c82cae08e9f916c10043526f221bd22",
"md5": "b0d493046e080ab3e2cfa64897259b87",
"sha256": "1f807c81f29c18327f0a557e0536d6694fa13d0e91d6c6d4ef373b854257a093"
},
"downloads": -1,
"filename": "codemp-0.8.4-cp312-none-win_amd64.whl",
"has_sig": false,
"md5_digest": "b0d493046e080ab3e2cfa64897259b87",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.8",
"size": 1066202,
"upload_time": "2024-11-17T14:17:02",
"upload_time_iso_8601": "2024-11-17T14:17:02.109013Z",
"url": "https://files.pythonhosted.org/packages/93/36/1a314d552c252536b275ef7655613c82cae08e9f916c10043526f221bd22/codemp-0.8.4-cp312-none-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ce8f9b3adc8e3f368ab9b2163a4c6ff8e91b247910bd5c6edf3a495601446c4c",
"md5": "4f6e31a89ca40c1112a037b68e506739",
"sha256": "ee47f0382cae72941a17d1f185eb2b1e9248d701a79d5e5d9b25376171dd7cf2"
},
"downloads": -1,
"filename": "codemp-0.8.4-cp38-abi3-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "4f6e31a89ca40c1112a037b68e506739",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8",
"size": 1013898,
"upload_time": "2024-11-17T14:16:59",
"upload_time_iso_8601": "2024-11-17T14:16:59.860524Z",
"url": "https://files.pythonhosted.org/packages/ce/8f/9b3adc8e3f368ab9b2163a4c6ff8e91b247910bd5c6edf3a495601446c4c/codemp-0.8.4-cp38-abi3-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4e97513204f94b4f4ebf1c6afb18ed8014d8d7ebe1c03ac0554e8278a746c9cd",
"md5": "de1870ea4c4b73f0c6239e1c2336b67a",
"sha256": "19e170e688690ef3fe99d6fc566bba1fe9c96a8f771e03065f24f304b4930bc1"
},
"downloads": -1,
"filename": "codemp-0.8.4-cp38-abi3-manylinux_2_34_x86_64.whl",
"has_sig": false,
"md5_digest": "de1870ea4c4b73f0c6239e1c2336b67a",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8",
"size": 1136247,
"upload_time": "2024-11-17T14:16:56",
"upload_time_iso_8601": "2024-11-17T14:16:56.977583Z",
"url": "https://files.pythonhosted.org/packages/4e/97/513204f94b4f4ebf1c6afb18ed8014d8d7ebe1c03ac0554e8278a746c9cd/codemp-0.8.4-cp38-abi3-manylinux_2_34_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "799c200aa434ce91059299191880c9b8a9b7ea8509832efaf536fb20d30ccc00",
"md5": "788421aa7c7f4e5da42d80bfa503106d",
"sha256": "27491e478a2bac082bb1677cb0e5c96dc840c643b4388aa4211ab1245f587c96"
},
"downloads": -1,
"filename": "codemp-0.8.4-cp38-abi3-win_amd64.whl",
"has_sig": false,
"md5_digest": "788421aa7c7f4e5da42d80bfa503106d",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8",
"size": 1073226,
"upload_time": "2024-11-17T14:17:06",
"upload_time_iso_8601": "2024-11-17T14:17:06.706127Z",
"url": "https://files.pythonhosted.org/packages/79/9c/200aa434ce91059299191880c9b8a9b7ea8509832efaf536fb20d30ccc00/codemp-0.8.4-cp38-abi3-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bb39d8edad1f23474d8d1d5cf333b073144f9857f6915695ccde1bbd849e2320",
"md5": "e70d0a2510337a8f24a1464d625403b6",
"sha256": "d96855d7f171e38365340d72938a2c08bc6c95359b999e16ab605fb6d8239458"
},
"downloads": -1,
"filename": "codemp-0.8.4.tar.gz",
"has_sig": false,
"md5_digest": "e70d0a2510337a8f24a1464d625403b6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 81396,
"upload_time": "2024-11-17T14:17:04",
"upload_time_iso_8601": "2024-11-17T14:17:04.353580Z",
"url": "https://files.pythonhosted.org/packages/bb/39/d8edad1f23474d8d1d5cf333b073144f9857f6915695ccde1bbd849e2320/codemp-0.8.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-17 14:17:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hexedtech",
"github_project": "codemp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "codemp"
}
JSON
