NSE_project

An exercise to pull Natonal Stock Exchange Data a(India) for stock market trend analysis

Project Setup

Here we provide some details about the project setup. Most of the choices are explained in the guide. Links to the relevant sections are included below. Feel free to remove this text when the development of the software package takes off.

For a quick reference on software development, we refer to the software guide checklist.

Version control

Once your Python package is created, put it under version control! We recommend using git and github.

cd nse_project
git init
git add -A
git commit

To put your code on github, follow this tutorial.

Python versions

This repository is set up with Python versions: * 3.4 * 3.5 * 3.6

Add or remove Python versions based on project requirements. The guide contains more information about Python versions and writing Python 2 and 3 compatible code.

Package management and dependencies

You can use either pip or conda for installing dependencies and package management. This repository does not force you to use one or the other, as project requirements differ. For advice on what to use, please check the relevant section of the guide.

• Dependencies should be added to setup.py in the install_requires list.

Packaging/One command install

You can distribute your code using pipy or conda. Again, the project template does not enforce the use of either one. The guide can help you decide which tool to use for packaging.

Testing and code coverage

• Tests should be put in the tests folder.
• The tests folder contains:
  • Example tests that you should replace with your own meaningful tests (file: test_nse_project)
  • A test that checks whether your code conforms to the Python style guide (PEP 8) (file: test_lint.py)
• The testing framework used is PyTest
  • PyTest introduction
• Tests can be run with python setup.py test
  • This is configured in setup.py and setup.cfg
• Use Travis CI to automatically run tests and to test using multiple Python versions
  • Configuration can be found in .travis.yml
  • Getting started with Travis CI
• TODO: add something about code quality/coverage tool?
• Relevant section in the guide

Documentation

• Documentation should be put in the docs folder. The contents have been generated using sphinx-quickstart (Sphinx version 1.6.5).
• We recommend writing the documentation using Restructured Text (reST) and Google style docstrings.
  • Restructured Text (reST) and Sphinx CheatSheet
  • Google style docstring examples.
• The documentation is set up with the Read the Docs Sphinx Theme.
  • Check out the configuration options.
• To generate html documentation run python setup.py build_sphinx
  • This is configured in setup.cfg
  • Alternatively, run make html in the docs folder.
• The docs/_templates directory contains an (empty) .gitignore file, to be able to add it to the repository. This file can be safely removed (or you can just leave it there).
• To put the documentation on Read the Docs, log in to your Read the Docs account, and import the repository (under 'My Projects').
  • Include the link to the documentation in this README.
• Relevant section in the guide

Coding style conventions and code quality

• Check your code style with prospector
• You may need run pip install .[dev] first, to install the required dependencies
• You can use yapf to fix the readability of your code style and isort to format and group your imports
• Relevant section in the guide

Package version number

• We recommend using semantic versioning.
• For convenience, the package version is stored in a single place: nse_project/__version__.py. For updating the version number, you only have to change this file.
• Don't forget to update the version number before making a release!

CHANGELOG.rst

• Document changes to your software package
• Relevant section in the guide

CITATION.cff

• To allow others to cite your software, add a CITATION.cff file
• It only makes sense to do this once there is something to cite (e.g., a software release with a DOI).
• Follow the making software citable section in the guide.

CODE_OF_CONDUCT.rst

• Information about how to behave professionally
• Relevant section in the guide

CONTRIBUTING.rst

• Information about how to contribute to this software package
• Relevant section in the guide

MANIFEST.in

• List non-Python files that should be included in a source distribution
• Relevant section in the guide

NOTICE

• List of attributions of this project and Apache-license dependencies
• Relevant section in the guide

Installation

To install nse_project, do:

git clone https://github.com/rajkumar-d83/nse_project.git
cd nse_project
pip install .

Run tests (including coverage) with:

python setup.py test

Documentation

Include a link to your project's full documentation here.

Contributing

If you want to contribute to the development of NSE_project, have a look at the contribution guidelines.

License

Copyright (c) 2019, None

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

Credits

This package was created with Cookiecutter and the NLeSC/python-template.