[](https://dev.azure.com/amostj/synapse-to-ipynb/_build/latest?definitionId=12&branchName=main)
# Synapse-to-IPython Notebook (synapse-to-ipynb)
[Azure Synapse Analytics](https://azure.microsoft.com/en-au/products/synapse-analytics/) uses notebooks for various computational tasks however managing these in a local dev environment and with proper version control is difficult. If this is a problem you have run into, this tool might be for you.
This program was designed primarily for use in a CI/CD pipeline.
## Features
- Create new IPython notebooks from Synapse notebooks
- Delete IPython notebooks that don't exist in Synapse notebooks
- Update Synapse notebooks from IPython notebooks
## Installation
```
pip install synapse-to-ipynb
```
## Workflow and Usage
1. Create Synapse notebooks directly in Synapse
2. Create ipynbs from Synapse notebooks. The source Synapse directory is considered the point of truth and so the default behaviour is that if the target already contains .ipynb files, ones that don't have a matching Synapse notebook will be deleted:
```
synapse-to-ipynb --source <synapse_directory> --target <ipython_directory>
```
- `--source`: The source directory containing Synapse notebooks (.json).
- `--target`: The target directory to store IPython Notebooks (.ipynb).
3. Develop the .ipynb files in your faviourite IDE
4. To migrate the changes back to Synapse use the `--update` flag:
```
synapse-to-ipynb --source <synapse_directory> --target <ipython_directory> --update
```
- `--source`: The source directory containing Synapse notebooks (.json).
- `--target`: The target directory to store IPython Notebooks (.ipynb).
- `--update`: Put the tool in update mode
## Contributing
Feedback and contributions are welcome! If you encounter any issues or have suggestions for improvement, please create an issue or submit a pull request.
## License
This project is licensed under the [MIT License](LICENSE).
Raw data
{
"_id": null,
"home_page": "https://github.com/jordanamos/synapse-to-ipynb",
"name": "synapse-to-ipynb",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "synapse,jupyter,convert,ipynb,synch,notebook,notebooks",
"author": "Jordan Amos",
"author_email": "jordan.amos@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/5a/6d/9916b60e09baee8e00b2cad6f3c97e230cac9cc01898f4c8341ec279fda2/synapse_to_ipynb-1.2.1.tar.gz",
"platform": null,
"description": "[](https://dev.azure.com/amostj/synapse-to-ipynb/_build/latest?definitionId=12&branchName=main)\n# Synapse-to-IPython Notebook (synapse-to-ipynb)\n\n[Azure Synapse Analytics](https://azure.microsoft.com/en-au/products/synapse-analytics/) uses notebooks for various computational tasks however managing these in a local dev environment and with proper version control is difficult. If this is a problem you have run into, this tool might be for you.\n\nThis program was designed primarily for use in a CI/CD pipeline.\n\n\n## Features\n\n- Create new IPython notebooks from Synapse notebooks\n- Delete IPython notebooks that don't exist in Synapse notebooks\n- Update Synapse notebooks from IPython notebooks\n\n## Installation\n\n```\npip install synapse-to-ipynb\n```\n\n## Workflow and Usage\n\n1. Create Synapse notebooks directly in Synapse\n\n2. Create ipynbs from Synapse notebooks. The source Synapse directory is considered the point of truth and so the default behaviour is that if the target already contains .ipynb files, ones that don't have a matching Synapse notebook will be deleted:\n\n ```\n synapse-to-ipynb --source <synapse_directory> --target <ipython_directory>\n ```\n\n - `--source`: The source directory containing Synapse notebooks (.json).\n - `--target`: The target directory to store IPython Notebooks (.ipynb).\n\n3. Develop the .ipynb files in your faviourite IDE\n\n4. To migrate the changes back to Synapse use the `--update` flag:\n ```\n synapse-to-ipynb --source <synapse_directory> --target <ipython_directory> --update\n ```\n - `--source`: The source directory containing Synapse notebooks (.json).\n - `--target`: The target directory to store IPython Notebooks (.ipynb).\n - `--update`: Put the tool in update mode\n\n## Contributing\n\nFeedback and contributions are welcome! If you encounter any issues or have suggestions for improvement, please create an issue or submit a pull request.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tool for managing and converting Synapse notebooks to Jupyter notebooks",
"version": "1.2.1",
"project_urls": {
"Homepage": "https://github.com/jordanamos/synapse-to-ipynb"
},
"split_keywords": [
"synapse",
"jupyter",
"convert",
"ipynb",
"synch",
"notebook",
"notebooks"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "382c7d7e4acd3485ffb478de9954347a5c17868b710e25d713055c5bb66a4a60",
"md5": "75a9fb176db7acccacce6c1ff2b4373a",
"sha256": "89c30d431769fafa7ce22945543da896fb62b92adb2f6db998efee2c7d2dac6b"
},
"downloads": -1,
"filename": "synapse_to_ipynb-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "75a9fb176db7acccacce6c1ff2b4373a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 6436,
"upload_time": "2023-11-30T03:36:40",
"upload_time_iso_8601": "2023-11-30T03:36:40.854460Z",
"url": "https://files.pythonhosted.org/packages/38/2c/7d7e4acd3485ffb478de9954347a5c17868b710e25d713055c5bb66a4a60/synapse_to_ipynb-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5a6d9916b60e09baee8e00b2cad6f3c97e230cac9cc01898f4c8341ec279fda2",
"md5": "5bbf205b4f5ffa6d783e531fbaa5d9b8",
"sha256": "f71c87aec44f64b63b4aaad8364f5d7732c9643d25f769e85e0a16db3cdd22d5"
},
"downloads": -1,
"filename": "synapse_to_ipynb-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "5bbf205b4f5ffa6d783e531fbaa5d9b8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 7510,
"upload_time": "2023-11-30T03:36:44",
"upload_time_iso_8601": "2023-11-30T03:36:44.032914Z",
"url": "https://files.pythonhosted.org/packages/5a/6d/9916b60e09baee8e00b2cad6f3c97e230cac9cc01898f4c8341ec279fda2/synapse_to_ipynb-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-30 03:36:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jordanamos",
"github_project": "synapse-to-ipynb",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "synapse-to-ipynb"
}
JSON
