Metadata-Version: 2.1
Name: 3gpp-citations
Version: 1.1.4
Summary: This project generates BiBTeX-files for 3GPP specifications.
Home-page: https://github.com/martisak/3gpp-citations
Author: Martin Isaksson
Author-email: martin.isaksson@gmail.com
License: MIT
Description: # 3GPP Bibtex entry generator
        
        [![Build Status](https://travis-ci.org/martisak/3gpp-citations.svg?branch=master)](https://travis-ci.org/martisak/3gpp-citations) ![](https://img.shields.io/github/issues-raw/martisak/3gpp-citations.svg?style=flat) ![](https://img.shields.io/github/license/martisak/3gpp-citations.svg?style=flat) [![Coverage Status](https://coveralls.io/repos/github/martisak/3gpp-citations/badge.svg?branch=master)](https://coveralls.io/github/martisak/3gpp-citations?branch=master) [![Gitter chat](https://badges.gitter.im/martisak/3gpp-citations.png)](https://gitter.im/3gpp-citations/community "Gitter chat") [![](https://img.shields.io/pypi/v/3gpp-citations.svg?style=flat)](https://pypi.org/project/3gpp-citations/) ![](https://img.shields.io/pypi/dd/3gpp-citations.svg?style=flat) ![](https://img.shields.io/pypi/pyversions/3gpp-citations.svg?style=flat) [![HitCount](http://hits.dwyl.io/martisak/3gpp-citations.svg)](http://hits.dwyl.io/martisak/3gpp-citations) ![](https://img.shields.io/codeclimate/maintainability/martisak/3gpp-citations.svg?style=flat)
        
        This project aims to generate [BiBTeX](http://www.bibtex.org/) files that
        can be used when citing [3GPP](3gpp.org) specifications. The input is a document list exported from the [3GPP Portal](https://portal.3gpp.org/).
        
        ## Installation
        
        `pip install 3gpp-citations`
        
        To also install test dependencies run
        
        `pip install 3gpp-citations[test]`
        
        ## Instructions
        
        1. Go to the [3GPP Portal](https://portal.3gpp.org/#55936-specifications)
        2. Generate the list of specifications you want.
        3. Download to Excel and save file
        4. Run `python 3gpp-citations.py -i exported.xlsx -o 3gpp.bib`
        5. Use in LaTeX.
        
        *Optionally* use the provided `3gpp.bib` directly.
        
        ## Things to note
        
        * The output `bibtex` class is set to `@techreport`.
        * If you add the option `--xelatex`, break-symbols `\-` will be used in url-fields.
        * The version and date are read from 3gpp.org, but it is slow so it takes a while to parse the list. If you find an easy solution to this, let me know.
        
        ## Example output
        
        ~~~
        @techreport{3gpp.36.331,
         author = {3GPP},
         day = {20},
         institution = {{3rd Generation Partnership Project (3GPP)}},
         month = {04},
         note = {Version 14.2.2},
         number = {36.331},
         title = {{Evolved Universal Terrestrial Radio Access (E-UTRA); Radio Resource Control (RRC); Protocol specification}},
         type = {Technical Specification (TS)},
         url = {https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=2440},
         year = {2017}
        }
        ~~~
        
        ## Contribute
        
        See our [contribution guidelines](CONTRIBUTING.md) and our [Code of Conduct](CODE_OF_CONDUCT.md).
        
        ## Acknowledgment
        
        This project has been updated as part of the [WASP Software and Cloud Technology](http://wasp-sweden.org/graduate-school/courses/software-and-cloud-technology-spring-2019/) course.
        
        This work was partially supported by the Wallenberg AI, Autonomous Systems and Software Program (WASP) funded by the Knut and Alice Wallenberg Foundation.
        
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Natural Language :: English
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4
Description-Content-Type: text/markdown
Provides-Extra: test
