Metadata-Version: 2.1
Name: bundestag-drucksache
Version: 0.1.3
Summary: Download and find official Drucksache objects from the bundestag. Search yourself there: https://pdok.bundestag.de
Home-page: https://github.com/AdriDevelopsThings/bundestag-drucksache
Author: adridoesthings
Author-email: github@adridoesthings.com
License: gpl-3.0
Download-URL: https://github.com/AdriDevelopsThings/bundestag-drucksache/archive/refs/tags/0.1.3.tar.gz
Description: # bundestag-drucksache
        
        Download and find official Drucksache objects from the bundestag. Search yourself there: https://pdok.bundestag.de
        
        # Installation
        
        ```shell
        pip install bundestag-drucksache
        ```
        
        # How to use?
        
        ## Drucksache
        ```python
        from bundestag_drucksache import Drucksache
        
        # Get object
        
        d = Drucksache(19, 28444)
        d = Drucksache.get("19/28444") # get the object by the identification
        d = Drucksache.parse_from_link("https://dip21.bundestag.de/dip21/btd/19/284/1928444.pdf") # parse object by the link
        
        # Do things with the object
        
        if d.exists(): # checks if the Drucksache pdf exists
            pdf_link = d.pdf_link # get the link to the pdf file
            identification = d.identification # get identification id like 19/28444
            
            # Download PDF
            d.download_pdf("drucksache.pdf")
            # or 
            file = open("drucksache.pdf", "wb")
            d.download_pdf(file, close_file=False)
        ```
        
        ## Search
        
        ```python
        from bundestag_drucksache import search_drucksache, Drucksache
        
        page = 1
        drucksache: list[Drucksache] = search_drucksache(
            search="Stadtentwicklung",
            legislaturperiode=19,
            offset=(page - 1) * 10 # the request would be answered with 10 items, so you need 10 as offset for page 2.
                                   # the default value for offset is 0 (starting offset).
        )
        # You can set start_date or end_date but note that time ranges are very unsafe.
        # Read following Warning:
        """
        [WARNING] for start_date and end_date: The datetime filtering is extremely unsafe,
                because the server doesn't have any method for datetime filtering,
                the response data would be filtered by the client. But you get only the first 10 elements,
                so time filtering is not possible.
        """
        ```
        
        # Config (not important)
        
        You can pass config values for `search_drucksache` and `Drucksache` (`__init__`, `get`, `parse_from_link`).
        You can pass all values eachself or create a `bundestag_drucksache.config.Config` object and pass the object
        as the `config` kwarg.
        
        The keys and default values are:
        ```json
        {
          "pdok": "https://pdok.bundestag.de",
          "dserver": "https://dserver.bundestag.de"
        }
        ```
Keywords: bundestag,drucksache,germany,politic,parliament
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
