# Table of content
0. [What's this, what it's need it?](#what's-this,-what-it's-need-it?) - description of package
1. [Installation](#installation) - how to install package
2. [Setup](#setup) - how to setup package
3. [How script is work](#how-script-is-work) - description of working
4. [TODO](#todo) - what i need todo in nearby future (task list for me)
# 🧐What's this, what it's need it?
This script (library) need for upload to sftp before commit files which was changed. It's very comfortable script for me, but if you need it you can use it ! :)
# 📥Installation
With pip:
`pip install sftp-uploader`
With poetry:
`poetry add sftp-uploader`
# ⚙️ Setup
For setup sftp config, you need to execure command `sftp_setup`. After this, you need to input `host`, `port`, `user`, `password` of your sftp server, and after that input a path to remote directory which contain your project,
for example:
Your project in /path/to/my/project
Your input `/path/to/my/project` <b>WITHOUT</b> slash in the end (in future a fix it, but now - it's work how it's work), and this directory need to be <b>EXIST</b>
After that script add config file to `.gitignore` and add script to load files in `pre-commit` hook file of git. And that's it! Your perfect!!!
<hr>
You can change in any time config (config name - `sftp_config.json` in root project directory), if you need it, or if any step is broken you can re-execute command and get success result, if
any step do not need it, script just skip it and all.
# 💪How script is work
Script after you execure command `sftp_setup` ask you a questions about sftp configuration, exactly `host`, `port`, `username`, `password` of sftp connection and after that you remote directory of project root.
After you fill this mini-form, a script create a file `sftp_config.json` which contain all of this information (not encrypted, it's just a `json` format), and with configuration of sftp and filling form is end.
Next step it's create `git` (if not exists) and `gitignore` file (if not exist), after that, script add `sftp_config.json` file to `gitignore` (i think you don't need save your sftp data in your github 😁).
In the next step, script create or use existed `pre-commit` file, which contain `bash` script which start before you make a commit, you can see a little logs about proccess, how it start,
which files upload which not upload, and after that you can make a commit.
# 🤔TODO
[x] Make title, description, which problem is solve, metter of this project description
[ ] Add more [classifiers](https://pypi.org/classifiers/)
[ ] Add tests
[x] Add additional links to project conf
[x] Add poetry scripts and pre-commit scripts
[x] Add poetry post install, if git exists and to gitignore and setup pre commit hook, and setup config module, if not exists, create and setup it
Raw data
{
"_id": null,
"home_page": "https://github.com/moonvent/sftp_uploader/",
"name": "sftp-uploader",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11,<4.0",
"maintainer_email": "",
"keywords": "sftp,git,commit",
"author": "Moonvent",
"author_email": "moonvent@proton.me",
"download_url": "https://files.pythonhosted.org/packages/4f/9a/8abeb7bfa14a2fe695bc0cb4e452cd8c4a06bda965065bc9a81a1668f2c5/sftp_uploader-1.0.16.tar.gz",
"platform": null,
"description": "# Table of content\n\n0. [What's this, what it's need it?](#what's-this,-what-it's-need-it?) - description of package\n1. [Installation](#installation) - how to install package\n2. [Setup](#setup) - how to setup package\n3. [How script is work](#how-script-is-work) - description of working\n4. [TODO](#todo) - what i need todo in nearby future (task list for me)\n\n# \ud83e\uddd0What's this, what it's need it?\n\nThis script (library) need for upload to sftp before commit files which was changed. It's very comfortable script for me, but if you need it you can use it ! :)\n\n# \ud83d\udce5Installation\n\nWith pip: \n\n`pip install sftp-uploader`\n\nWith poetry:\n\n`poetry add sftp-uploader`\n\n# \u2699\ufe0f Setup\n\nFor setup sftp config, you need to execure command `sftp_setup`. After this, you need to input `host`, `port`, `user`, `password` of your sftp server, and after that input a path to remote directory which contain your project,\nfor example: \n\n Your project in /path/to/my/project\n Your input `/path/to/my/project` <b>WITHOUT</b> slash in the end (in future a fix it, but now - it's work how it's work), and this directory need to be <b>EXIST</b>\n\nAfter that script add config file to `.gitignore` and add script to load files in `pre-commit` hook file of git. And that's it! Your perfect!!!\n\n<hr>\n\nYou can change in any time config (config name - `sftp_config.json` in root project directory), if you need it, or if any step is broken you can re-execute command and get success result, if\nany step do not need it, script just skip it and all.\n\n# \ud83d\udcaaHow script is work\n\nScript after you execure command `sftp_setup` ask you a questions about sftp configuration, exactly `host`, `port`, `username`, `password` of sftp connection and after that you remote directory of project root.\nAfter you fill this mini-form, a script create a file `sftp_config.json` which contain all of this information (not encrypted, it's just a `json` format), and with configuration of sftp and filling form is end.\n\nNext step it's create `git` (if not exists) and `gitignore` file (if not exist), after that, script add `sftp_config.json` file to `gitignore` (i think you don't need save your sftp data in your github \ud83d\ude01).\n\nIn the next step, script create or use existed `pre-commit` file, which contain `bash` script which start before you make a commit, you can see a little logs about proccess, how it start, \nwhich files upload which not upload, and after that you can make a commit.\n\n# \ud83e\udd14TODO\n\n[x] Make title, description, which problem is solve, metter of this project description\n\n[ ] Add more [classifiers](https://pypi.org/classifiers/)\n\n[ ] Add tests\n\n[x] Add additional links to project conf\n\n[x] Add poetry scripts and pre-commit scripts\n\n[x] Add poetry post install, if git exists and to gitignore and setup pre commit hook, and setup config module, if not exists, create and setup it\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Package for upload data in before commit uncommited files to sftp server",
"version": "1.0.16",
"project_urls": {
"Bug Tracker": "https://github.com/moonvent/sftp_uploader/issues/",
"Documentation": "https://github.com/moonvent/sftp_uploader/blob/master/README.md",
"Homepage": "https://github.com/moonvent/sftp_uploader/",
"Repository": "https://github.com/moonvent/sftp_uploader/"
},
"split_keywords": [
"sftp",
"git",
"commit"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ce447b738e5b4bb76f53b17e71d45eb3d4adcffb1f6172691082e6723d2d6716",
"md5": "d426eedfe7a1c61f2b1c375412490c17",
"sha256": "a0028c415dbe125751deed21d856c1279de13b53fefd3442fd7cd3571d16bdfb"
},
"downloads": -1,
"filename": "sftp_uploader-1.0.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d426eedfe7a1c61f2b1c375412490c17",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11,<4.0",
"size": 15404,
"upload_time": "2023-06-04T13:38:05",
"upload_time_iso_8601": "2023-06-04T13:38:05.629403Z",
"url": "https://files.pythonhosted.org/packages/ce/44/7b738e5b4bb76f53b17e71d45eb3d4adcffb1f6172691082e6723d2d6716/sftp_uploader-1.0.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4f9a8abeb7bfa14a2fe695bc0cb4e452cd8c4a06bda965065bc9a81a1668f2c5",
"md5": "1dec30ef34e6e96ee202c97e188b282a",
"sha256": "9ce127f46126e5a76e977c9e60fbd54b66382bd2dc5b59670ade4d1748555cd2"
},
"downloads": -1,
"filename": "sftp_uploader-1.0.16.tar.gz",
"has_sig": false,
"md5_digest": "1dec30ef34e6e96ee202c97e188b282a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11,<4.0",
"size": 11234,
"upload_time": "2023-06-04T13:38:06",
"upload_time_iso_8601": "2023-06-04T13:38:06.901277Z",
"url": "https://files.pythonhosted.org/packages/4f/9a/8abeb7bfa14a2fe695bc0cb4e452cd8c4a06bda965065bc9a81a1668f2c5/sftp_uploader-1.0.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-04 13:38:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "moonvent",
"github_project": "sftp_uploader",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "sftp-uploader"
}
JSON
