Metadata-Version: 1.1
Name: fixYabinary
Version: 0.2.2
Summary: Tool to Fix Yabinary File
Home-page: https://github.com/tkmru/fixYabinary
Author: @tkmru
Author-email: i.am.tkmru@gmail.com
License: MIT License
Description: ===========
        fixYabinary
        ===========
        
        | This is Python Library to fix "Yabinary" file like foremost. 
         The term "Yabinary" in Japanese mean "Dangerous Binary". 
        | This library can be useful for CTF. It supports Python 2 & 3. 
        | docment in Japanese(http://tkmr.hatenablog.com/entry/2014/03/25/222207) 
        
        change log
        ==========
        
        | 0.2.2
        | bug fix
        | 0.2.1
        | rewrite something, and change how to extend().
        | 0.2.0
        | can use in command line.
        
        Installation
        ============
        
        ----
        PyPI
        ----
        The recommended process is to install the PyPI package, as it allows easily staying update.
        
        ::
        
            $ pip install fixYabinary
        
        ------
        github
        ------
        Download from https://github.com/tkmru/fixYabinary/.
        Let's push star!!
        
        
        Usage
        =====
        
        ---------------
        look(file_path)
        ---------------
        
        print Binary like hexdump command.
        
        ::
        
            >> import fixYabinary
            >> fixYabinary.look("./test.png")
        
                       00 01 02 03 04 05 06 07   08 09 0A 0B 0C 0D 0E 0F
            0x000000   00 00 00 00 49 45 4e 44   ae 42....
        
        
        It can be used in command line.
        
        ::
        
            $ fixYabinary -l test.png
        
        
        ----------------------
        get(file_path, option)
        ----------------------
        
        | return Binary data. If option is "f" , you get Formated Binary.
        | You must not set option.
        
        ::
        
            >> import fixYabinary
            >> fixYabinary.get("./test.png")
            0000000049454e44ae42....
        
            >>fixYabinary.get("./test.png", "f")
            00 00 00 00 49 45 4e 44 ae 42....
        
        
        ------------------------------------------------------------------------------
        extend(file_path, new_file_path, hex, bytes, option)
        ------------------------------------------------------------------------------
        
        | make new file that file is extended.
          extend function intepret that byte is decimal.  
        | option is None or "t" or "b". option is None by default. 
        
        ::
        
            >> import fixYabinary
            >> fixYabinary.get("./test.png", "./extended", "00", 3)
        
            Succeeded in making ./extended.
            # 000000 + ./test.png's Binary Data + 000000 in ./extended
        
        
            >> fixYabinary.get("./test.png", "./extended", "00", 3, "t")
        
            Succeeded in making ./extended.
            # 000000 + ./test.png's Binary Data in ./extended 
        
        
            >> fixYabinary.get("./test.png", "./extended", "00", 3, "b")
        
            Succeeded in making ./extended.
            # ./test.png's Binary Data + 000000 in ./extended  
        
        
        It can be used in command line in case option is None.
        
        ::
        
            $ fixYabinary -e test.png extended 00 3
        
        
        -------------------
        identify(file_path)
        -------------------
        
        identify file type in file. return file type.
        
        ::
        
            >> import fixYabinary
            >> fixYabinary.get("./extended")
            ./extended  include following file type
            png
        
        
        It can be used in command line.
        
        ::
        
            $ fixYabinary -i extended
        
        
        -------------------------------------------------------------
        extract(file_path, new_file_path, start_address, end_address)
        -------------------------------------------------------------
        
        cut out binary data, and write it into new file.
        If start_address and end_address is str, they are interpreted hex.
        If start_address and end_address is int, they are interpreted decimal.
        
        ::
        
            >> import fixYabinary
            >> fixYabinary.extract("./extended", "./result", 4 , 124)
            Succeeded in making ./result
        
        and auto detect file in file, and write it into new file.
        
        ::
        
            >> import fixYabinary
            >> fixYabinary.extract("./extended", "./result")
            Succeeded in making ./result.png
        
        
        It can be used in command line.
        
        ::
        
            $ fixYabinary -r extended result 4 124  # set start_address and end_address
        
            $ fixYabinary -a extended result        # auto extract file in file
            
        
        
        License
        =======
        
        MIT License
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        Copyright (c) @tkmru 
Keywords: binary,ctf
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
