| Name | fshare JSON |
| Version |
1.1.3
JSON |
| download |
| home_page | |
| Summary | A python package that serves as an easy file sharing application over local network |
| upload_time | 2023-09-27 15:38:37 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.0 |
| license | |
| keywords |
file
share
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# File Share - Local File Sharing Service
fshare is a Python package that serves as a file sharing service over a local network. It utilizes Flask to create a local server on port 8000, allowing users to upload files and share them within the network.
## Installation
To install fshare, use pip:
```bash
pip install fshare
```
All of the required dependencies (`flask >= 1.0.0`) will be installed automatically by pip.
## Running the Service
To start the file-sharing service, run the following command:
```bash
python -m fshare
```
You're all set! Servers is up and running on http://localhost:8000
Default save-location is the temp directory (`/tmp/fshare` on unix like systems or `%tmp%/fshare` on windows)
## Command-Line Options
fshare supports the following command-line options:
```plaintext
usage: python -m fshare [-h] [--bind BIND] [--port PORT] [--location LOCATION]
Starts the python file-sharing service application
options:
-h, --help show this help message and exit
--bind BIND, -b BIND The local address to bind the server
--port PORT, -p PORT File server port to run on
--location LOCATION, -l LOCATION
The path to the folder where files will be stored
(default: /tmp/fshare)
```
### Options
- `-h`, `--help`: Displays the help message and exits.
- `--bind BIND`, `-b BIND`: Sets the local address to bind the server (optional).
- `--port PORT`, `-p PORT`: Specifies the file server port to run on (optional).
- `--location LOCATION`, `-l LOCATION`: Sets the path to the folder where files will be stored. By default, files are stored in `/tmp/fshare`.
## Example Usage
Here's an example of running fshare with custom options:
```bash
python -m fshare --port 8080 --location /path/to/custom/folder
```
This will start the file-sharing service on port 8080 and use `/path/to/custom/folder` as the file storage location.
## Running programatically
Fshare can be imported in your project alongside with a reference to the `FileManager` class and the `flask` app.
```python
from fshare.main import app, fileManager
# change the save-location path
# fileManager.changeLocation('/new/location/path')
app.run(host='0.0.0.0', port=8000, debug=True)
```
## Contributing
We welcome contributions from the community! If you find any issues, have suggestions for improvements, or want to add new features, please feel free to open an issue or submit a pull request on our GitHub repository.
## License
fshare is open-source software released under the MIT License. See the [LICENSE](LICENSE) file for more details.
## Issues
For any issues or feedback, please visit the [Bug Tracker](https://github.com/stevomitric/fshare/issues) on GitHub.
## Contact
For questions or inquiries, you can reach out to Stevo Mitric at stevomitric2000@gmail.com.
## Disclaimer
File-Share is provided "as is" without warranty of any kind, express or implied. Use it at your own risk. The authors of File-Share are not responsible for any damages or liabilities resulting from the use of this package.
## Acknowledgments
- fshare is built with the help of Flask and other open-source libraries.
- Special thanks to the Python community for their continuous support.
Raw data
{
"_id": null,
"home_page": "",
"name": "fshare",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.0",
"maintainer_email": "Stevo Mitric <stevomitric2000@gmail.com>",
"keywords": "file,share",
"author": "",
"author_email": "Stevo Mitric <stevomitric2000@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/bf/29/4b20b201bda062e43d208bcb37592901be1e171f545748c328e55298e376/fshare-1.1.3.tar.gz",
"platform": null,
"description": "\n# File Share - Local File Sharing Service\n\nfshare is a Python package that serves as a file sharing service over a local network. It utilizes Flask to create a local server on port 8000, allowing users to upload files and share them within the network.\n\n## Installation\n\nTo install fshare, use pip:\n\n```bash\npip install fshare\n```\n\nAll of the required dependencies (`flask >= 1.0.0`) will be installed automatically by pip.\n\n## Running the Service\n\nTo start the file-sharing service, run the following command:\n\n```bash\npython -m fshare\n```\n\nYou're all set! Servers is up and running on http://localhost:8000\n\n\nDefault save-location is the temp directory (`/tmp/fshare` on unix like systems or `%tmp%/fshare` on windows)\n\n## Command-Line Options\n\nfshare supports the following command-line options:\n\n```plaintext\nusage: python -m fshare [-h] [--bind BIND] [--port PORT] [--location LOCATION]\n\nStarts the python file-sharing service application\n\noptions:\n -h, --help show this help message and exit\n --bind BIND, -b BIND The local address to bind the server\n --port PORT, -p PORT File server port to run on\n --location LOCATION, -l LOCATION\n The path to the folder where files will be stored\n (default: /tmp/fshare)\n```\n\n### Options\n\n- `-h`, `--help`: Displays the help message and exits.\n- `--bind BIND`, `-b BIND`: Sets the local address to bind the server (optional).\n- `--port PORT`, `-p PORT`: Specifies the file server port to run on (optional).\n- `--location LOCATION`, `-l LOCATION`: Sets the path to the folder where files will be stored. By default, files are stored in `/tmp/fshare`.\n\n## Example Usage\n\nHere's an example of running fshare with custom options:\n\n```bash\npython -m fshare --port 8080 --location /path/to/custom/folder\n```\n\nThis will start the file-sharing service on port 8080 and use `/path/to/custom/folder` as the file storage location.\n\n## Running programatically\n\nFshare can be imported in your project alongside with a reference to the `FileManager` class and the `flask` app.\n\n```python\nfrom fshare.main import app, fileManager\n\n# change the save-location path\n# fileManager.changeLocation('/new/location/path')\n\napp.run(host='0.0.0.0', port=8000, debug=True)\n\n```\n\n## Contributing\n\nWe welcome contributions from the community! If you find any issues, have suggestions for improvements, or want to add new features, please feel free to open an issue or submit a pull request on our GitHub repository.\n\n## License\n\nfshare is open-source software released under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## Issues\n\nFor any issues or feedback, please visit the [Bug Tracker](https://github.com/stevomitric/fshare/issues) on GitHub.\n\n## Contact\n\nFor questions or inquiries, you can reach out to Stevo Mitric at stevomitric2000@gmail.com.\n\n## Disclaimer\n\nFile-Share is provided \"as is\" without warranty of any kind, express or implied. Use it at your own risk. The authors of File-Share are not responsible for any damages or liabilities resulting from the use of this package.\n\n## Acknowledgments\n\n- fshare is built with the help of Flask and other open-source libraries.\n- Special thanks to the Python community for their continuous support.\n",
"bugtrack_url": null,
"license": "",
"summary": "A python package that serves as an easy file sharing application over local network",
"version": "1.1.3",
"project_urls": {
"Bug Tracker": "https://github.com/stevomitric/fshare/issues",
"Homepage": "https://github.com/stevomitric/fshare"
},
"split_keywords": [
"file",
"share"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "77974002590dc1e83d6ec51f8ddf3f4e6353baaec692553fbc0178723c3da1e8",
"md5": "62fddf90ff06f1dc57b01a04b3333901",
"sha256": "720ebc122b2ec27612a7952966108fa038af05333d02a38dc3be8dfdf98c6044"
},
"downloads": -1,
"filename": "fshare-1.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "62fddf90ff06f1dc57b01a04b3333901",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.0",
"size": 6925,
"upload_time": "2023-09-27T15:38:35",
"upload_time_iso_8601": "2023-09-27T15:38:35.608474Z",
"url": "https://files.pythonhosted.org/packages/77/97/4002590dc1e83d6ec51f8ddf3f4e6353baaec692553fbc0178723c3da1e8/fshare-1.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bf294b20b201bda062e43d208bcb37592901be1e171f545748c328e55298e376",
"md5": "c772b27c970b5956fdecc965ddff920d",
"sha256": "096113f723cba68ed8820a451540197ebad7fe5ca56a6671c51a90cae70ecd23"
},
"downloads": -1,
"filename": "fshare-1.1.3.tar.gz",
"has_sig": false,
"md5_digest": "c772b27c970b5956fdecc965ddff920d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.0",
"size": 7444,
"upload_time": "2023-09-27T15:38:37",
"upload_time_iso_8601": "2023-09-27T15:38:37.272817Z",
"url": "https://files.pythonhosted.org/packages/bf/29/4b20b201bda062e43d208bcb37592901be1e171f545748c328e55298e376/fshare-1.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-27 15:38:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stevomitric",
"github_project": "fshare",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "fshare"
}
