Subversion Repositories Misc

Next Major Version -- so far

fib.py

Usage:  python fib.py (COMMAND) [ OPTIONS ]

where

        COMMAND

                is required, and is ONE of

        -h, --help  show this help message and exit

        --all       do everything -- get civic addresses, run bot, and produce KMLs

        --newdb     download civic addresses and make a new, empty database

        --crawl     query the Bell Aliant server, finding DSL statuses

        --kml       generate a KML overlay from a database

        --stats     print the totals of each DSL status

        --list      print every selected address

                However, only --help, --kml, --stats, and --list work now.

        OPTIONS

                are optional, at last, and can include

        -h, --help            show this help message and exit

        --db=FILE             SQlite database file to work with. Default:

                              database.sqlite

        --dslmask=MASK        DSL types to process; y/n for each of EMPTY, NODSL,

                              BASIC, & ULTRA. Overrides defaults: crawl=ynnn,

                              stats=yyyy, kml=nyyy

        --sparsity=INT        minimum difference in civic numbers along a road to

                              process. Overrides defaults: crawl=1, stats=1, kml=40

        --nocities            don't process addresses in Charlottetown or Summerside

        --max                 process more addresses when using a >1 sparsity.

        --always-get=HOUSE    ignoring sparsity, which address on the end of a road

                              to always get. Values: 'none', 'first' (default),

                              'last', 'both'.

        --sql-where=SQL       custom SQL SELECT conditions. Inserted directly after

                              WHERE. Be careful!

        --coord-rect=latA,longA,latB,longB

                              latitude/longitude coordinates limiting processing to

                              addresses within the rectangle

        --tsv=TSV-FILE        TSV database of civic addresses to add to SQlite

                              database. Can appear multiple times.

        --override-robot-exclusion-standard

                              override a robots.txt, instead of asking

        --quiet-fail          don't ask about a robots.txt -- just exit

        --delay=SECONDS       time to sleep between single-threaded requests to Bell

                              Aliant server. Can be float. Default: 1.0

        --no-connect          Don't reconnect HTTP connection between requests.

                              Experimental, will probably fail.

        --useragent=NAME      user-agent for the bot to represent itself with.

                              Default: forgottenislanderbot

        --pause-every=QUERIES

                              number of requests to run between database-commit /

                              kill-opportunity sleep

        --pause-time=SECONDS  time to sleep at an intermittent pause

        --map=KMLFILE         file to write KML to. Will be overwritten. Default:

                              dslmap.kml

        --globe=[GE|NWW]      virtual-globe to optimize KML for

        --civic-addresses-in-kml

                              Label icons in KML by civic address. May raise privacy

                              concerns, file size, lag.

        --no-highlight        Disable highlightable icons in KML. Experimental.

        --kmz                 Make a compressed KMZ from the KML.

        --iconsize=FLOAT      Size of KML icons. Default: 1.0

        --icontheme=[NAME|ante*post.png]

                              Icons to use in KML. Either builtin, like 'GM', or

                              external, like 'dsl-*.png', where '*' comprises

                              'ERROR', 'EMPTY', 'NODSL', 'BASIC', and 'ULTRA', in

                              separate files. It can also be a URL.

        --iconhotspot=x,y     Pixel coords in an icon where it is aligned over the

                              lat/long coords.

        --iconcolours=LIST    Colours to tint KML icons, as comma-separated list of

                              five colours like 'bf0000ff', in 'AABBGGRR' format.

        --pipeable            Changes stdout flushing behavior. May cause problems

                              on some systems. Not implemented.

        --verbose             Prints additional information. Not implemented.

        --debug               Prints massive amounts of debug information.

                              Implemented as necessary.

                the only ones that work, of course, are the ones which control

                --kml, --stats, and --list