I made a new Borsdata client build on modern Python principles.

Author: alexwox

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ""
+labels: bug
+assignees: ""
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+1. Initialize client with '...'
+2. Call method '....'
+3. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Code Sample**
+
+```python
+# Add your code here
+```
+
+**Environment (please complete the following information):**
+
+- OS: [e.g. Ubuntu 20.04]
+- Python Version: [e.g. 3.8]
+- Package Version: [e.g. 0.1.0]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/python-tests.yml

@@ -0,0 +1,35 @@
+name: Python Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.7, 3.8, 3.9, "3.10"]
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements-dev.txt
+      - name: Run tests
+        run: |
+          pytest --cov=src/borsdata_client tests/
+        env:
+          BORSDATA_API_KEY: ${{ secrets.BORSDATA_API_KEY }}
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v3
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false

.gitignore

@@ -0,0 +1,107 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# PyCharm
+.idea/
+
+# VS Code
+.vscode/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cursor IDE
+.cursor/
+.cursor.json
+.cursor-cache/
+
+# Mac OS
+.DS_Store
+
+# Pytest
+pytest-report.xml
+
+# Coverage
+coverage-report/
+
+# Logs
+*.log

CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# Contributing to Borsdata API Client
+
+Thank you for considering contributing to the Borsdata API Client! This document provides guidelines and instructions for contributing.
+
+## Code of Conduct
+
+Please be respectful and considerate of others when contributing to this project.
+
+## How to Contribute
+
+1. Fork the repository
+2. Create a new branch for your feature or bugfix: `git checkout -b feature/your-feature-name` or `git checkout -b fix/your-bugfix-name`
+3. Make your changes
+4. Run tests to ensure your changes don't break existing functionality: `pytest`
+5. Commit your changes with a descriptive commit message
+6. Push your branch to your fork: `git push origin your-branch-name`
+7. Create a pull request to the main repository
+
+## Development Setup
+
+1. Clone the repository
+2. Create a virtual environment: `python -m venv .venv`
+3. Activate the virtual environment:
+   - Windows: `.venv\Scripts\activate`
+   - Unix/MacOS: `source .venv/bin/activate`
+4. Install development dependencies: `pip install -r requirements-dev.txt`
+5. Create a `.env` file with your Borsdata API key:
+   ```
+   BORSDATA_API_KEY=your_api_key_here
+   ```
+
+## Testing
+
+Run tests with pytest:
+
+```bash
+pytest
+```
+
+For coverage report:
+
+```bash
+pytest --cov=src/borsdata_client tests/
+```
+
+## Code Style
+
+This project follows PEP 8 style guidelines with a line length of 88 characters. We use Black for code formatting and isort for import sorting.
+
+Format your code before submitting:
+
+```bash
+black src tests
+isort src tests
+```
+
+## Type Hints
+
+All code should include proper type hints according to PEP 484.
+
+## Documentation
+
+Please update documentation when adding or modifying features. This includes:
+
+- Docstrings for new functions, methods, and classes
+- Updates to README.md if necessary
+- New or updated examples in the docs directory
+
+## Pull Request Process
+
+1. Ensure your code passes all tests
+2. Update documentation if necessary
+3. The PR should work for Python 3.7 and above
+4. Your PR will be reviewed by maintainers, who may request changes
+
+## License
+
+By contributing to this project, you agree that your contributions will be licensed under the project's MIT License.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.