fa-signal-provider


Namefa-signal-provider JSON
Version 1.1.26 PyPI version JSON
download
home_pageNone
SummaryA model library for all signal providers of Freya Alpha using python. It includes models to handle signal ingestion, signal status reports, profit & performance reports, etc.
upload_time2024-03-31 08:13:42
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords finance trading models
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # fa-signal-provider
A model library for all signal providers of Freya Alpha using python. It includes models to handle signal ingestion, signal status reports, profit and performance reports, etc.

## Sponsors
Freya Alpha,
The Kára System,
Spark & Hale Robotic Industries


## General
Run and compiled for Python 3.9.13.
Expected to run for Python 3+

## Development

### Testing
run tests with `pytest -s -vv` to see all the details. This is extremely important for the library. It could make multiple pods fail.

### Installation as Consuming Developer

Simply run: `pip install fa-signal-provider`

Import in modules without the dash (e.g.): `from fasignalprovider.trading_signal import TradingSignal`

### Setup as Contributor
Create the virtul environment: 
```
py -m venv .venv
```
Start the Environment: 
```
./.venv/Scripts/activate
```
 (or allow VS Code to start it). Use `deactivate`to stop it.

Upgrade the PIP.
```
python -m pip install --upgrade pip
```

All the required libraries must be listed in requirements.txt and installed by  
```
python -m pip install -r .\requirements.txt
```
For Dev use 
```
python -m pip install -r .\requirements-dev.txt
```

To cleanup the environment run:
```
pip3 freeze > to-uninstall.txt
```
 and then
```
pip3 uninstall -y -r to-uninstall.txt
```

or 
```
pip3 install pip-autoremove
```

### Build Library
Prerequisite: make sure that you give your Operating System user the right to modify files in the python directory. The directory where pyhton is installed.
Use `python setup.py bdist_wheel` to create the dist, build and .eggs folder.

## Reference from a different project
In order to use your own version of the project - to maybe contribute to the library - simply clone the code from github into new directory. Then add the path of that new directory to the requirements.txt file of your project. Then change in fa-signal-provider whatever you recommend to improve. Don't forget the Open-Closed Principle: extend only (unless it requires a breaking change)


## Releasing a new version

Simply commit and push into MAIN. Make sure you have tested well.

Github Actions (.github/workflows/testing_and_deployment.yml) will deploy the file to pypi.org.

### Manual and old process

Delete any old files in the /dist and build folder of your local environment.
Update your pip: 
```
python -m pip install --upgrade pip
```

Install the tools build, twine and bumpver: 
```
python -m pip install build twine bumpver
```
Upgrade the setuptools: 

```
pip install --upgrade setuptools
```

Bump the version in pyproject.toml: 
```
bumpver update --patch
```
This will commit a new version to GitHub.

Build the project: 
```
python -m build
```

Check the distribution: 
```
twine check dist/*
```

Upload to test-pypi to validate: 
```
twine upload -r testpypi dist/*
```

Login with username: (password should be known)

If the test-upload was successful, finally, upload to pypi production: 

```
twine upload dist/*
```

Done.

(P.S. Do not forget to update the library in your projects: `pip install --upgrade fa-signal-provider`)bumpver update --patch


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "fa-signal-provider",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "finance, trading, models",
    "author": null,
    "author_email": "Brayan Svan <hello@freya-alpha.com>",
    "download_url": "https://files.pythonhosted.org/packages/26/fa/0f2f408b3e2d5c0831987bd970ffb36fcc9a571d4f7c7edf8f9dc3a0c6c2/fa-signal-provider-1.1.26.tar.gz",
    "platform": null,
    "description": "# fa-signal-provider\nA model library for all signal providers of Freya Alpha using python. It includes models to handle signal ingestion, signal status reports, profit and performance reports, etc.\n\n## Sponsors\nFreya Alpha,\nThe K\u00e1ra System,\nSpark & Hale Robotic Industries\n\n\n## General\nRun and compiled for Python 3.9.13.\nExpected to run for Python 3+\n\n## Development\n\n### Testing\nrun tests with `pytest -s -vv` to see all the details. This is extremely important for the library. It could make multiple pods fail.\n\n### Installation as Consuming Developer\n\nSimply run: `pip install fa-signal-provider`\n\nImport in modules without the dash (e.g.): `from fasignalprovider.trading_signal import TradingSignal`\n\n### Setup as Contributor\nCreate the virtul environment: \n```\npy -m venv .venv\n```\nStart the Environment: \n```\n./.venv/Scripts/activate\n```\n (or allow VS Code to start it). Use `deactivate`to stop it.\n\nUpgrade the PIP.\n```\npython -m pip install --upgrade pip\n```\n\nAll the required libraries must be listed in requirements.txt and installed by  \n```\npython -m pip install -r .\\requirements.txt\n```\nFor Dev use \n```\npython -m pip install -r .\\requirements-dev.txt\n```\n\nTo cleanup the environment run:\n```\npip3 freeze > to-uninstall.txt\n```\n and then\n```\npip3 uninstall -y -r to-uninstall.txt\n```\n\nor \n```\npip3 install pip-autoremove\n```\n\n### Build Library\nPrerequisite: make sure that you give your Operating System user the right to modify files in the python directory. The directory where pyhton is installed.\nUse `python setup.py bdist_wheel` to create the dist, build and .eggs folder.\n\n## Reference from a different project\nIn order to use your own version of the project - to maybe contribute to the library - simply clone the code from github into new directory. Then add the path of that new directory to the requirements.txt file of your project. Then change in fa-signal-provider whatever you recommend to improve. Don't forget the Open-Closed Principle: extend only (unless it requires a breaking change)\n\n\n## Releasing a new version\n\nSimply commit and push into MAIN. Make sure you have tested well.\n\nGithub Actions (.github/workflows/testing_and_deployment.yml) will deploy the file to pypi.org.\n\n### Manual and old process\n\nDelete any old files in the /dist and build folder of your local environment.\nUpdate your pip: \n```\npython -m pip install --upgrade pip\n```\n\nInstall the tools build, twine and bumpver: \n```\npython -m pip install build twine bumpver\n```\nUpgrade the setuptools: \n\n```\npip install --upgrade setuptools\n```\n\nBump the version in pyproject.toml: \n```\nbumpver update --patch\n```\nThis will commit a new version to GitHub.\n\nBuild the project: \n```\npython -m build\n```\n\nCheck the distribution: \n```\ntwine check dist/*\n```\n\nUpload to test-pypi to validate: \n```\ntwine upload -r testpypi dist/*\n```\n\nLogin with username: (password should be known)\n\nIf the test-upload was successful, finally, upload to pypi production: \n\n```\ntwine upload dist/*\n```\n\nDone.\n\n(P.S. Do not forget to update the library in your projects: `pip install --upgrade fa-signal-provider`)bumpver update --patch\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A model library for all signal providers of Freya Alpha using python. It includes models to handle signal ingestion, signal status reports, profit & performance reports, etc.",
    "version": "1.1.26",
    "project_urls": {
        "Homepage": "https://github.com/svabra/fa-signal-provider"
    },
    "split_keywords": [
        "finance",
        " trading",
        " models"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "592be917ddecdf13abbade30b2ab0a57ec99c9dd0c10f87329c50d3ce73ba72c",
                "md5": "9897126d0b9bb61f51ae606b09f6642b",
                "sha256": "93a19a0ccb76b3775b1640d5396406a7a76934070b469e7047b27fb95cafacd1"
            },
            "downloads": -1,
            "filename": "fa_signal_provider-1.1.26-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9897126d0b9bb61f51ae606b09f6642b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 15885,
            "upload_time": "2024-03-31T08:13:38",
            "upload_time_iso_8601": "2024-03-31T08:13:38.408673Z",
            "url": "https://files.pythonhosted.org/packages/59/2b/e917ddecdf13abbade30b2ab0a57ec99c9dd0c10f87329c50d3ce73ba72c/fa_signal_provider-1.1.26-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "26fa0f2f408b3e2d5c0831987bd970ffb36fcc9a571d4f7c7edf8f9dc3a0c6c2",
                "md5": "9ee096412079d2b620c165ddd149ac07",
                "sha256": "cc6ebb01ff4820101feb1aa183259746faf331e94e89e97a70494cfa5106ec40"
            },
            "downloads": -1,
            "filename": "fa-signal-provider-1.1.26.tar.gz",
            "has_sig": false,
            "md5_digest": "9ee096412079d2b620c165ddd149ac07",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 16681,
            "upload_time": "2024-03-31T08:13:42",
            "upload_time_iso_8601": "2024-03-31T08:13:42.227939Z",
            "url": "https://files.pythonhosted.org/packages/26/fa/0f2f408b3e2d5c0831987bd970ffb36fcc9a571d4f7c7edf8f9dc3a0c6c2/fa-signal-provider-1.1.26.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-31 08:13:42",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "svabra",
    "github_project": "fa-signal-provider",
    "github_not_found": true,
    "lcname": "fa-signal-provider"
}
        
Elapsed time: 0.21158s