Metadata-Version: 2.1
Name: c
Version: 0.1.0
Summary: Android battery history analyZer
Home-page: https://github.com/1337/c
Author: Brian
Author-email: brian@ohai.ca
License: UNKNOWN
Description: # C
        
        This is a battery history analyZer for android and compatible systems.
        
        The package includes library functions for extracting battery data from
        collections of CSV files, as well as a helper CLI to generate charts
        from the terminal.
        
        ## Installing
        
        This is a python 3 package, and requires python 3.5.
        To install, type in the terminal:
        
            pip3 install c
        
        ## Configuration
        
        There is nothing to configure in this package, but you must configure
        your android device to output CSV files in this format:
        
            YYYY-MM-DD,HH.mm,!C,!D,!V,!C2
        
        Special formats are defined as follows:
        
        * `!C`: the capacity ("percentage") of your battery at the time, from
          0 to 100.
        * `!D`: whether your screen was on at the time, as `on` or `off`.
        * `!V`: the voltage of your battery, in microvolts. `4000000` means 4V.
        * `!C2`: the design capacity of the battery at the time.
        
        The device *must* append a new entry every 10 minutes, specifically,
        whenever the time's minute mod 10 is 0.
        
        ## Running
        
        To see all graphs:
        
            $ c overview
        
        To see individual graphs:
        
            $ c that_graph_name  # listed in cli.py
        
        To see just the stats:
        
            $ c stats
            ------------------------------  -------------  ------------  ---------
                                            Last 395 days  Last 30 days  Last week
            Data points                     52529          4165          826
            Times charged to 100%           24             0             0
            Times charged to 90%            72             14            0
            Times charged to 80%            185            16            0
            Time spent between 20%~80% (%)  94.26          92.29         100.0
            Time spent between 45%~58% (%)  41.43          42.3          68.64
            Average voltage (V)             3.88           3.91          3.91
            Charge events*                  2344           134           37
            Discharge events*               1305           74            18
        
            Screen on per day (hrs)         7.63           2.63          1.74
              - Mondays                     7.5            3.17          0.33
              - Tuesdays                    7.35           1.5           0.83
              - Wednesdays                  6.81           1.79          0.83
              - Thursdays                   7.4            3.0           1.67
              - Fridays                     6.94           2.42          1.52
              - Saturdays                   8.26           3.9           5.65
              - Sundays                     9.23           2.72          4.11
            ------------------------------  -------------  ------------  ---------
        
        If you are developing:
        
            $ python -m c.cli
        
        ## Name
        
        C is one of the characters in one of my grandparents' names.
        
        ## LicenSe
        
        This project is licenSed under the GPL v3 licenSe.
        
        ## Changelog
        
        ### 0.1.0
        
        Add a capacity column.
        
        ### 0.0.6
        
        Save figures only if the `figs` directory is available.
        Fix issue with blank files.
        
        ### 0.0.5
        
        Fix command line when handling 'stats'.
        
        ### 0.0.3
        
        Add an actual command line.
        
        ### 0.0.2
        
        Fix execution in virtual envs with imports in relative paths.
        
        ### 0.0.1
        
        Initial release.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Description-Content-Type: text/markdown
