Merge pull request #16 from metaodi/develop

Release 0.0.2

CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/) and this project follows [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.0.2] - 2020-06-10
+### Added
+- Support for explain operation
+- Response classes
+- Tests for the existing functionality
+- `maximum_records` parameter for Client
+- Example scripts in the `examples` directory
+- CHANGELOG.md and CONTRIBUTING.md
+
+### Changed
+- XMLParser is now a class, so that XML namespaces can be changed on-the-fly
+
+## [0.0.1] - 2020-05-23
+### Added
+- Initial release of sruthi
+- basic support for searchretrieve operation
+
+
+
+# Categories
+- `Added` for new features.
+- `Changed` for changes in existing functionality.
+- `Deprecated` for once-stable features removed in upcoming releases.
+- `Removed` for deprecated features removed in this release.
+- `Fixed` for any bug fixes.
+- `Security` to invite users to upgrade in case of vulnerabilities.
+
+[Unreleased]: https://github.com/metaodi/sruthi/compare/v0.0.2...HEAD
+[0.0.2]: https://github.com/metaodi/sruthi/compare/v0.0.1...v0.0.2
+[0.0.1]: https://github.com/metaodi/sruthi/releases/tag/v0.0.1

CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing
+
+If you want to participate in this project, please follow this guidline.
+
+Fork and clone this repository:
+
+```bash
+git clone [email protected]:your-username/sruthi.git
+```
+
+Install the dependencies using `pip`:
+
+```bash
+pip install -r requirements.txt
+pip install -r test-requirements.txt
+```
+
+Make sure the tests pass:
+
+```bash
+pytest
+```
+
+To ensure a good quality of the code use `flake8` to check the code style:
+
+```bash
+flake8 --install-hook git
+```
+
+## Create a pull request
+
+1. Choose the `develop` branch as a target for new/changed functionality, `master` should only be targeted for urgent bugfixes.
+2. While it's not strictly required, it's highly recommended to create a new branch on your fork for each pull request.
+3. Push to your fork and [submit a pull request][pr].
+4. Check if the [build ran successfully][ci] and try to improve your code if not.
+
+At this point you're waiting for my review.
+I might suggest some changes or improvements or alternatives.
+
+Some things that will increase the chance that your pull request is accepted:
+
+* Write tests.
+* Follow the Python style guide ([PEP-8][pep8]).
+* Write a [good commit message][commit].
+
+[pr]: https://github.com/metaodi/sruthi/compare/
+[ci]: https://github.com/metaodi/sruthi/actions
+[pep8]: https://www.python.org/dev/peps/pep-0008/
+[commit]: https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html

README.md

@@ -82,3 +82,13 @@ sruthi has been tested with the following schemas:
 * [Dublin Core Record Schema](https://www.loc.gov/standards/sru/recordSchemas/dc-schema.html) (dc)
 * [MARCXML: The MARC 21 XML Schema](https://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd) (marcxml)
 * [ISAD(G): General International Standard Archival Description, Second edition](https://www.expertisecentrumdavid.be/xmlschemas/isad.xsd) (isad)
+
+## Release
+
+To create a new release, follow these steps (please respect [Semantic Versioning](https://semver.org/)):
+
+1. Adapt the version number in `sruthi/__init__.py`
+1. Update the CHANGELOG with the version
+1. Create a pull request to merge `develop` into `master` (make sure the tests pass!)
+1. Create a [new release/tag on GitHub](https://github.com/metaodi/sruthi/releases) (on the master branch)
+1. The [publication on PyPI](https://pypi.python.org/pypi/sruthi) happens via [GitHub Actions](https://github.com/metaodi/sruthi/actions?query=workflow%3A%22Upload+Python+Package%22) on every tagged commit

sruthi/__init__.py

@@ -1,5 +1,7 @@
-__version__ = '0.0.1'
+__version__ = '0.0.2'
+__all__ = ['errors', 'sru', 'client']
 
-from .errors import (SruthiError, ServerIncompatibleError, SruError, NoMoreRecordsError) # noqa
+from .errors import SruthiError, ServerIncompatibleError, SruError, NoMoreRecordsError # noqa
+from .errors import SruthiWarning, WrongNamespaceWarning # noqa
 from .sru import searchretrieve, explain # noqa
-from .client import Client  # noqa
+from .client import Client # noqa